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About this document 


This document describes some of the commands used at the UCS DMS-250 
MAP terminal. 


Intended audience 
This document is intended for administration and maintenance personnel. 


How this document is organized 


Commands in this manual are grouped alphabetically under their respective 
directories. 


The following information is presented in the description (when applicable) 
of each command: 


Purpose—full command name and a description of its use; datafill 
characteristics that enable the command to function as designed are also 
included 


Restrictions—requirements that control command operation 
Access—sequence used to access the command 
Syntax—command structure with parameters 
Parameters—command element(s) description 

Example command—samples of actual use 


Responses—system-based response to successful command completion 
and/or error messages 


Related commands—other commands that perform similar or related 
tasks 
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How to check the version and issue of this document 


The version and issue of the document are indicated by numbers, for 
example, 01.01. 


The first two digits indicate the version. The version number increases each 
time the document is updated to support a new software release. For 
example, the first release of a document is 01.01. In the next software release 
cycle, the first release of the same document is 02.01. 


The second two digits indicate the issue. The issue number increases each 
time the document is revised but rereleased in the same software release 
cycle. For example, the second release of a document in the same software 
release cycle is 01.02. 


To determine which version of this document applies to the software in your 
office and how documentation for your product is organized, check the 
release information in UCS DMS-250 Master Index, 297-2621-001. 


This document is written for all UCS DMS-250 offices. More than one 
version of this document may exist. To determine whether you have the 
latest version of this document and how documentation for your product is 
organized, check the release information in UCS DMS-250 Master Index, 
297-2621-001. 


References in this document 


For information on commands not documented in this book, refer to online 
help or the following related documents: 


e DMS-100 Family Software Optionality Control User’s Manual, 
297-8991-901 


e UCS DMS-250 Software Optionality Control User’s Manual, 
297-2621-301 


e UCS DMS-250 Billing Records Application Guide, 297-2621-395 

e UCS DMS-250 NetworkBuilder Application Guide, 297-2621-370 

e UCS DMS-250 Data Schema Reference Manual, 297-2621-851 

e UCS DMS-250 ISDN Reference Manual, 297-2621-106 

e UCS DMS-250 Logs Reference Manual, 297-2621-840 

e UCS DMS-250 Office Parameters Reference Manual, 297-2621-855 


e UCS DMS-250 Operational Measurements Reference Manual, 
297-2621-814 
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e UCS DMS-250 NT6X50EC Integrated Echo Canceller Application 
Guide, 297-2621-365 


Information about related documents can be found in either the UCS 
DMS-250 Master Index, 297-2621-001, or the Product Documentation 
Directory, 297-8991-001. 


What precautionary messages mean 


The types of precautionary messages used in Nortel documents include 
attention boxes and danger, warning, and caution messages. 


An attention box identifies information that is necessary for the proper 
performance of a procedure or task or the correct interpretation of 


information or data. Danger, warning, and caution messages indicate 
possible risks. 


Examples of the precautionary messages include: 


ATTENTION Information needed to perform a task 


ATTENTION 
If the unused DS-3 ports are not deprovisioned before a DS-1/VT 
Mapper is installed, the DS-1 traffic will not be carried through the 
DS-1/VT Mapper, even though the DS-1/VT Mapper is properly 
provisioned. 


DANGER Possibility of personal injury 


DANGER 

Risk of electrocution 

Do not open the front panel of the inverter unless fuses 
F1, F2, and F3 have been removed. The inverter contains 
high-voltage lines. Until the fuses are removed, the 
high-voltage lines are active, and you risk being 
electrocuted. 


WARNING Possibility of equipment damage 
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WARNING 

Damage to the backplane connector pins 

Align the card before seating it, to avoid bending the 
backplane connector pins. Use light thumb pressure to 
align the card with the connectors. Next, use the levers on 
the card to seat the card into the connectors. 


CAUTION Possibility of service interruption or degradation 


CAUTION 

Possible loss of service 

Before continuing, confirm that you are removing the card 
from the inactive unit of the peripheral module. 
Subscriber service will be lost if you remove a card from 
the active unit. 


Document conventions 
This document conforms to the following conventions: 


Input prompt (>) 
An input prompt (>) indicates that the information that follows is a 
command: 


>BSY 


Commands and fixed parameters 


Commands and fixed parameters that are entered at a MAP terminal are 
shown in uppercase letters: 


>BSY CTRL 


Variables 
Variables are shown in lowercase letters: 


>BSY CTRL cirl_no 


The letters or numbers that the variable represents must be entered. Each 
variable is explained in a list that follows the command string. 


Responses 
Responses correspond to the MAP display and are shown in a different type: 
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FP 3 Busy CTRL 0: Command request has been submitted. 
FP 3 Busy CTRL 0: Command passed. 


The following excerpt from a procedure shows the command syntax used in 
this document: 


1 Manually busy the CTRL on the inactive plane by typing 


>BSY CTRL cirl_no 
and pressing the Enter key. 


where 
ctr_no isthe number of the CTRL (0 or 1) 
Example of a MAP response: 


FP 3 Busy CTRL 0: Command request has been submitted. 
FP 3 Busy CTRL 0: Command passed. 
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Introduction 
MAP display 


Commands are entered by operating company personnel at the user interface 
called the MAP terminal. These commands allow the user to perform the 
following: 


* request and access various information 
e perform testing, monitoring, and maintenance 
e disable and enable functions 


e obtain help on commands 


Display areas 


The command options that show on the MAP display depend on the 
differences in switch hardware and software configurations at the user site. 
Figure 1-1 shows an example of the trunk maintenance MTC level and how 
the MAP is separated into display areas. 
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Figure 1-1 
MAP display areas 
CM MS IOD Net PM CCS Trks Ext APPL 

System OG es he ae SG, Recetas 2 ee ee 
Command MTC i 
Area „0 Quit 7 

/2 Activity: , 
' 3  MTCNA i l 
'4 STSTATUS, | Work area 
| 5  BERP i l 
' 6 CPSTATUS, | 
i 7 o i 
'8 E 
„9 CM o, i 
' 10 MS i 
'11 IOD 
12 Net i l 
Menu — T 15 PM ig 
Command '14 CCS pa Command interpreter output area 
Area 15 

'16 Trks o 
ı 17 Ext 1 f 
-18 APPL oo, ee i 

U = userid ! 

ser ID paa s E BG Se E E E E E E E le Sse eS aes =e SS 23% 
mme | A eae 


Display levels 


Information at the MAP display is organized by levels (also called 
directories). The first level begins at the command interpreter (CI) level. 


The CI level is automatically accessed when a user logs on to the MAP. At 
the CI level, the command MAP command interpreter (MAPCTI) accesses the 
next display level or directory. Figure 1-2 shows an example of trunk 
maintenance levels/directories. 
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Figure 1-2 


Trunk maintenance MAP display level example 


Command levels Cl 
or directories 
MAPCI 
MTC 
TRKS 
STAT 
TKGRP TTP ATT CARRIER TRKSTRBL 
STAT 
TRKS CARPAC 
TRKCONV ISDNTC X75TTP C7TTP TTATTP 
DATA MONITOR MANUAL Cé6TTP N6TTP 


Command function 


Commands allow the user to do the following: 


perform a task within a command level/directory. 


access another command level/directory. For example, the MAPCI 
command allows access to the MTC command level. 


Digital Switching Systems UCS DMS-250 Commands Reference Manual UCS17 


1-4 Introduction 


Command level/directory elements 


Figure 1-3 


Each command level or directory is made up of the following elements 
(Figure 1-3): 


e menu of the commands available at that level/directory 
e access to another command level/directory 

e alarm display of the overall subsystem status 

e status display of specified hardware or software 


e area to display responses to user commands 


Level/directory elements 
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Command 
Access 
Provides access to other command levels. 
For example, an entry of 16 or Trks accesses the 
Trunks command level. 
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Menu commands 


Menu commands are listed on the MAP display at each level. Access menu 
commands by typing the command itself or the number to the left of the 
command. 


Non-menu commands 
Non-menu commands (sometimes called hidden commands) are not 


displayed on the MAP in the menu command display area. However, these 
commands are available from the current level. 
Non-menu commands can include both of the following: 


e global commands—available from any level (also called CI commands 
because they are available from the CI level) 


e level-specific commands—available only from the current menu level 
(directory) 


Level-specific command information 


Certain commands entered at the MAP level provide information about the 
commands available at the current directory. 


LISTST command 


LISTST lists all the commands (both menu and non-menu) that are 
accessible at the current level. At the MAP level, enter the following: 


>LISTST 


The MAP lists all commands available at the current level. Command 
categories include: 


e commands that perform tasks 
e commands that access other levels (directories) 
e commands that appear on the menu 


e commands that do not appear on the menu 


PRINT command 


PRINT lists all the commands available within a directory. At the MAP level 
enter the command, followed by a space and the name of the command 
directory. For example: 


>PRINT directory 


The MAP displays a list of all commands available in the specified 
directory. 
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HELP command 


Some directories use HELP. Enter the command at the prompt in the 
directory where additional information is required. For example: 


>HELP 


The MAP displays helpful information about the specified directory. 


Command-specific information 


Enter ”Q”, followed by a space and a command name to display information 
about that command. For example: 


>Q command 


Information on whether the command accesses another directory or what 
task the command performs displays. 


Moving between command levels 


Certain commands entered at the MAP allow the user to move between the 
levels or directories. 


Command directory 


Enter the directory name at the prompt to go to the next command level. For 
example, to move from the CI level to the MAPCI level, enter: 


>MAPCI 

QUIT 
Enter the following at the prompt to move to the previous level: 
>QUIT 

QUIT ALL 


Enter the following at the prompt to move directly to the CI level: 


>QUIT ALL 


For more information on the MAP terminal and commands, refer to the 
specific manual dealing with particular commands (such as the Trunks 
Maintenance Guide for trunk maintenance-related commands) or to the 
Commands Reference Manual. 


Commands parameters 
Commands that perform a task often require one or more parameters. 
Parameters indicate the limits within which the command should perform. 
Use a blank space between parameters for proper operation. 
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The results of some commands are altered by the absence or presence of 
individual or groups of optional parameters. These cases are fully described 
in this manual. 


Required parameters 


Required parameters are necessary for the command to function properly. 
The MAPCI prompts for required parameters until they are entered. 


Optional parameters 
Optional parameters are not required for the command to work. The MAP 
CI does not prompt for optional parameters unless they are optional as a 
group and at least one optional parameter has been entered. 
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ACGCNTRL directory 
ACGCNTRL 


Purpose 


The Automatic Code Gapping Control (ACGCNTRL) command is used to 
display and update ACG control lists. These ACG control lists are used for 
Carrier Advanced Intelligent Network (CAIN) applications, using the 
Variable AIN Messaging VAMP) framework. The control lists reduce the 
number of outgoing queries from the UCS DMS-250 switch to the Service 
Control Point (SCP) by blocking specific queries. 


There are two types of controls that can be on the control lists: SCP overload 
Controls, and SMS Originated Control Codes (SOCC). 


e The SCP automatically sends SCP Overload Controls when it detects 
itself to be congested (Automatic Code Gapping). 


e The Subsystem Management System (SMS) is a provisioning and data 
management system on the SCP that can generate and send messages to 
the Service Switching Point (SSP). The SOCC are manually initiated to 
restrict certain queries at the SSP (Manual Code Gapping). SOCC 
control may also be added to the control list by an operator using the 
ACGCNTRL command. 


Access 


All ACGCNTRL commands are accessed through the ACGCNTRL 
directory. 


Syntax 
>ACGCNTRL 


Parameters 
None 


Responses 
None 
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ACGCNTRL directory 
ACGCNTRL (end) 


Related commands 
The following commands are found in the ACGCNTRL directory: 


ADD 
GLOBAL 
HELP 
LIST 
QUIT 


REMOVE 
RESET 
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ACGCNTRL commands 


ADD 


Purpose 


Access 
Syntax 


Parameters 


Table 1-1 


The Add (ADD) command is used to add Automatic Code Gapping (ACG) 
controls to the Service Management System (SMS) Originated Control Code 
(SOCC) control list for a given application. 


Note: Adding controls to the control list could prevent calls from querying 
the switching control point (SCP). 


>ACGCNTRL 


>ADD [<Application> <Control List> <TT> <GTA> <GAP> <Duration>] 


Command parameters are described in Table 1-1 


ADD parameter descriptions 


Parameter Values Description 

Application A valid application The application for which the control is being added. 
name as entered in 
table VAMPTRID. 

Control list SOCC The control list of the control to be added. (Restricted 

to the SOCC control list.) 

TT A valid translations The translations type to which the control is being 
type for the control added. 
to be added as 
specified in table 
C7GTTYPE. 

GTA Up to 24 digits The global title for the control to be added. (For CAIN 


a max of 10 digits will be allowed.) 
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ACGCNTRL commands 
ADD (continued) 


Table 1-1 


ADD parameier descriptions (continued) 


Parameter Values Description 
GAP 0, 010, 025,050,1, The gap interval value in seconds for the control to 
2, 5, 10, 15, 30, 60, be added. 
120, 300, 600, inf 
Note: The gap interval value is a random number. 
This number is chosen from within a uniform 
distribution between 50% and 100% of the supplied 
gap interval. 
Duration 1,2, 4, 8, 16, 32,64, The duration time, in seconds, that the control to be 


128, 256,512,1024, added is to remain in the control list. 


2048, inf 


Example command 


Responses 


>ADD CAIN02 SOCC CAIN_CLID_GT 214684 010 INF 
>LIST CAINO2 ALL 
>LIST CAINO2 ALL 


CAINO2 SOCC CAIN_CLID_GT 214684 0.10 


The following is a possible response to the ADD command. 


That Application is not valid. 


Explanation: 


DURATION 


An attempt was made to list controls for an application that does not 


exist in table VAMPTRID. 


System action: 
None. 


User action: 
Retry the command with a valid application name. 


Related commands 
The following commands are found in the ACGCNTRL directory: 


e GLOBAL 
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ACGCNTRL commands 
ADD (end) 


e HELP 
« LIST 

e QUIT 

e REMOVE 
e RESET 
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ACGCNTRL commands 
GLOBAL 


Purpose 


Access 


Syntax 


Parameters 


The GLOBAL command provides a Global Outgoing Control (GOC), a 
method of gapping outgoing requests to all SCP destinations. The GOC must 
supply a gap interval value of between 0 and 900 seconds, or a value of 
infinite (INF). 


The interaction between the GOC and the individual Automatic Control 
Gapping (ACG) controls can either be OVERRIDE or PREPROCESS. The 
interaction is specified through the ACGCNTRL CI command. When the 
interaction is OVERRIDE the GOC overrides all individual ACG controls, 
including zero-gap controls. 


When the interaction is PREPROCESS, individual ACG controls (including 
zero-gap controls) are processed and applied first. However, if no individual 
control applies, then the GOC is applied to the message. 


Note: Enabling a Global Outgoing Control will cause all outgoing messages 
to the SCP to be subject to gapping. This command should only be used 
when necessary. 


>ACGCNTRL 


>GLOBAL[<APPLICATION><WHAT> 
{<ENABLE> <GAP> <INTERACT> 
{ <OVERRIDE> } 
{ <PREPROCESS } } 
{<DISABLE> } ] 


Command parameters are described in Table 1-2. 


Digital Switching Systems UCS DMS-250 Commands Reference Manual UCS17 


1-14 Commands 


ACGCNTRL commands 
GLOBAL (continued) 


Table 1-2 
GLOBAL parameter descriptions 
Parameter Values Description 
<application> A valid application name as entered in table 
VAMPTRID. 
<what> ENABLE, DISABLE Enable or Disable GOC. 
<GAP> (0-900) or INF The gap interval for the Global Outgoing Control in 
seconds, or infinite. 
<INTERACT> OVERRIDE, The interaction between the GOC and individual 
PREPROCESS ACG controls. 
—end— 


Example commands 
>GLOBAL CAINO2 ENABLE 32 OVERRIDE 
WARNING: All outgoing messages will be gapped! 
Please confirm (“YES”, “Y”, or “N”): 
>Y 
Global Outgoing Control Enabled 


>LIST CAINO2 ALL 
APPL LIST TT GTA GAP DURATION 


The following Global Outgoing Controls are active: 
APPL LEIST INTERACTION GAP 


CAINO2 GLOBAL OVERRIDE 32 


>GLOBAL CAINO2 ENABLE INF PREPROCESS 
WARNING: All outgoing messages will be gapped! 
Please confirm (“YES”, “Y”, or “N”): 

>Y 

Global Outgoing Control Enabled 

> 


>GLOBAL CAINO2 DISABLE 
Global Outgoing Control Disabled 


Responses 
The following are possible responses to the GLOBAL command. 
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ACGCNTRL commands 
GLOBAL (end) 


That Application is not valid. 


Explanation: 
An attempt was made to list controls for an application that does not 
exist in table VAMPTRID. 


System action: 
None. 


User action: 
Retry the command with a valid application name. 


Please confirm (“YES”, “Y”, “NO”, or “N”): 


Explanation: 
This message is given to confirm the user’s attempt to enable the 
global control. 


System action: 
If the user answers ‘YES’ or ‘Y’ the global control is added to the 
control list. 


User action: 
Type ‘YES’, ‘Y’, ‘NO’ or N’ 


Related commands 
The following commands are found in the ACGCNTRL directory: 


ADD 
HELP 
LIST 
QUIT 
REMOVE 
RESET 
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HELP 


Purpose 
Use the Help (HELP) command to display text and information about the 
ACGCNTRL commands. If you do not specify a value for this command, 
the syntax for the command displays. 


Access 
>ACGCNTRL 
Syntax 
>HELP <FIELDS> 
Parameters 
Table 1-3 
COPY parameter descriptions 
Parameter Values Description 
<FIELDS> ACGCNTRL, The field you want help on. 
LIST, 
REMOVE, 
RESET, 
GLOBAL, 
HELP, 
QUIT 


Example commands 


>HELP ACGCNTRL 
ACGCNTRL: Display or remove ACG controls 


>HELP LIST 

LIST: 

Parms: <APPLICATION> STRING 

<WHAT> {SCP, 

SOCC, 
ALL, 
ZEROGAP, 
CRAFT } 
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ACGCNTRL commands 
HELP (continued) 


>HELP REMOVE 
REMOVE: 
Parms: <APPLICATION> STRING 
<CONTROL LIST> {SCP, 
SOCC } 
<TT> STRING 
<GTA> STRING 


>HELP RESET 

RESET: 

Parms: <APPLICATION> STRING 
<WHAT> {SCP, 


socc, 
ALL, 
NONZEROSOCC, 
CRAFT, 
NONZEROCRAFT} 
>HELP GLOBAL 
GLOBAL: 


Parms: <APPLICATION> STRING 
<WHAT> {ENABLE <GAP> {0 TO 900, 
INF} 
<INTERACT> {OVERRIDE, 
PREPROCESS}, 


DISABLE} 

>HELP HELP 

HELP: 

Parms: <FIELDS> {ACGCNTRL, 
LIST, 
REMOVE, 
RESET, 
GLOBAL, 
ADD, 
HELP, 
QUIT} 

>HELP QUIT 

QUIT 
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ACGCNTRL commands 
HELP (end) 


Related commands 
The following commands are found in the ACGCNTRL directory: 
e ADD 
e GLOBAL 
e LIST 
e QUIT 
e REMOVE 
e RESET 
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ACGCNTRL commands 
LIST 


Purpose 


The List (LIST) command lists specified Automatic Code Gapping (ACG) 
controls for a given Variable AIN Messaging Platform (VAMP) application. 
Use this command to list any of the following: 


e All the controls in the switching control point (SCP) control list 


e All the controls in the SMS Originated Control Code (SOCC) control 
lists 


e All the controls in both the SCP and SOCC control lists 
e Only the zero-gap controls 
e All the craft initiated controls 


Access 
>ACGCNTRL 


Syntax 
>LIST <Application> <What> 


Parameters 
Command parameters are described in Table 1-4 


Table 1-4 
LIST parameter descriptions 


Parameter Values Description 
Application A valid application name as entered in table 
VAMPTRID. 

What The information that the user wants listed: 
SCP, SCP = SCP control list 
SOCC, SOCC = SOCC control list 
ALL, ALL = SCP and SOCC control lists 
ZEROGAP, ZEROGAP = Only zero-gap controls 
CRAFT CRAFT = Craft initiated controls 
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ACGCNTRL commands 
LIST (continued) 


Example commands 
>LIST CAINO2 SCP 
>LIST CAINO2 SOCC 
>LIST CAINO2 ALL 
>LIST CAIN02 ZEROGAP 
>LIST CAINO2 CRAFT 


Responses 
The following are example responses to the LIST command: 


>LIST CAINO2 SCP 


APPL LIST rT GTA GAP DURATION 
CAINO2 SCP CAIN_CLID_GT 214684 2.94 128 
CAINO2 SCP CAIN_ADDR_GT 214684 3:93 64 
CAINO2 SCP CAIN_FEAT_GT 214685 32.94 1024 


APPL LIST TI GTA GAP DURATION 
CAINO2 SOCC CAIN_ADDR_GT 2146841234 0.40 16 
CAINO2 SOCC CAIN_CLID_GT 214 0.0 32 


APPL LIST TT GTA GAP DURATION 
CAINO2 SCP CAIN_CLID_GT 214684 2.94 128 
CAINO2 SOCC CAIN_CLID_GT 214 0.00 32 
CAINO2 SOCC CAIN_ADDR_GT 2146841234 0.40 16 
CAINO2 SCP CAIN_ADDR_GT 214684 3593) 64 
CAINO2 SCP CAIN_FEAT_GT 214685 32.94 1024 


>LIST CAINO2 ZEROGAP 


CAINO2 SOCC CAIN_CLID_GT 214 0.0 32 
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ACGCNTRL commands 
LIST (end) 
>LIST CAINO2 CRAFT 
APPL LIST TT. GTA GAP DURATION 
CAINO2 SOCC CAIN_ADDR_GT 2146841234 0.40 16 
CAINO2 SOCC CAIN_CLID_GT 214 0.0 32 


The following is a possible response to the LIST command. 


That application is not valid. 


Explanation: 
An attempt was made to list controls for an application that does not 
exist in table VAMPTRID. 


System action: 
None. 


User action: 
Retry the command with a valid application name. 


Related commands 
The following commands are found in the ACGCNTRL directory: 


e ADD 

e GLOBAL 
e HELP 

e QUIT 

e REMOVE 
e RESET 


Digital Switching Systems UCS DMS-250 Commands Reference Manual UCS17 


1-22 Commands 


ACGCNTRL commands 
QUIT (end) 


Purpose 


The Quit (QUIT) command exits the ACGCNTRL directory and returns to 
the command interpreter (CI:) prompt. 


Access 

>ACGCNTRL 
Syntax 

>QUIT 
Parameters 

None 


Example command 
>QUIT 


Responses 
The system returns to the CI: prompt. 


Related commands 
The following commands are found in the ACGCNTRL directory: 


e ADD 

e GLOBAL 
e HELP 

e LIST 

e REMOVE 
e RESET 
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ACGCNTRL commands 
REMOVE 


Purpose 


Access 
Syntax 


Parameters 


Table 1-5 


The Remove (REMOVE) command is used to delete an individual 
Automatic Code Gapping (ACG) control for a given application. 


Note: Removing an ACG control could allow queries to be sent to the 
switching control point (SCP) causing congestion at the SCP. 


>ACGCNTRL 


>REMOVE [<Application> <Control List> <TT> <GTA>] 


Command parameters are described in Table 1-5 


REMOVE parameter descriptions 


Parameter Values Description 
Application A valid application The application for which the control is being 
name as entered in removed. 
table VAMPTRID. 
Control list SOCC The control list of the control to be removed. 
[Restricted to the Service Management System 
(SMS) Originated Control Code (SOCC) list] 
TT A valid translations The translations type to which the control is being 
type for the control removed. 
to be removed as 
specified in table 
C7GTTYPE. 
GTA Up to 24 digits The global title for the control to be removed. 
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ACGCNTRL commands 
REMOVE (continued) 


Example command 
>REMOVE CAIN02 SOCC CAIN_ADDR_GT 2146841234 


ACG CONTROL TO BE REMOVED: 

CAINO2 SOCC CAIN_ADDR_GT 2146841234 
Please confirm (“YES”, “Y”, “NO”, or “N”): 

>N 


REMOVE REJECTED 


Responses 
The following are possible responses to the REMOVE command. 


That Application is not valid. 


Explanation: 
An attempt was made to list controls for an application that does not 
exist in table VAMPTRID. 


System action: 
None. 


User action: 
Retry the command with a valid application name. 


Please confirm (“YES”, “Y”, “NO”, or “N”): 


Explanation: 
This message is given to confirm the user’s attempt to remove an 
ACG control. 


System action: 
If the user answers ‘YES’ or ‘Y’ the control is removed, otherwise 
the command is rejected. 


User action: 
Type ‘YES’, ‘Y’, ‘NO’ or N’ 


Related commands 
The following commands are found in the ACGCNTRL directory: 


e ADD 
e GLOBAL 
e HELP 
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REMOVE (end) 
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ACGCNTRL commands 
RESET 


Purpose 


The Reset (RESET) command allows you to remove all the controls in a 
control list for a given Variable AIN Messaging Platform (VAMP) 
application. The following controls can be reset: 


e All the controls in the switching control point (SCP) control list 

e All the controls in the SMS Originated Control Code (SOCC) control list 
e All the controls in both the SCP and SOCC control lists 

e All the controls in the SOCC control list except the zero-gap controls 

e All the craft initiated SOCC controls 

e All the craft initiated non-zero gap SOCC controls 


Note: Resetting a control list removes ACG controls and could cause 
congestion at the SCP. 


Access 
>ACGCNTRL 
Syntax 
>RESET <Application> <What> 
Parameters 
The command parameters are described in Table 1-6. 
Table 1-6 


RESET parameter descriptions 


Parameter Values Description 
Application A valid application name as entered in table 
VAMPTRID. 

What The control list the user wants reset: 
SCP, SCP = SCP control list 
SOCC, SOCC = SOCC control list 
ALL, ALL = SCP and SOCC control lists 
NONZEROSOCC, NONZEROSOCC = SOCC control list except 
CRAFT, zero-gap control entries 


NONZEROCRAFT CRAFT = Craft initiated SOCC controls 
NONZEROCRAPFT = Craft initiated non-zero SOCC 
controls 
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ACGCNTRL commands 
RESET (continued) 


Example commands 
>RESET CAIN02 SCP 
>RESET CAINO2 SOCC 
>RESET CAINO2 ALL 
>RESET CAIN02 NONZEROSOCC 
>RESET CAIN02 CRAFT 
>RESET CAINO2 NONZEROCRAFT 


>RESET CAIN02 SCP 


WARNING: ALL SCP CONTROLS WILL BE 


REMOVED ! 


Please confirm (“YES”, “Y”, “NO”, 
>Y 
SCP CONTROL LIST RESET 


>RESET CAIN02 SOCC 


WARNING: ALL SOCC CONTROLS WILL BE 


Please confirm 
>N 
RESET REJECTED 


(“YES”, NY, “NO”, 


>RESET CAINO2 ALL 


WARNING: ALL SCP & SOCC CONTROLS WILL BE RE 


Please confirm 
>Y 

SCP CONTROL LIST RESET 
SOCC CONTROL LIST RESET 


(“YES”, WY “NO”, 


>RESET CAIN02 NONZEROSOCC 


or YN’) . 


REMOVED! 


or YN”) . 


‘MOVE 


or YN’) . 


WARNING: ALL NON-Z] 


FROGAP SOCC CONTROLS WILL 


BI 


E REMOV 


ED! 


Please confirm (“YES”, “Y”, “NO”, or “N”): 
>Y 
NON-ZEROGAP SOCC CONTROL LIST RESET 


>RESET CAIN02 CRAFT 

WARNING: ALL CRAFT INITIATED SOCC 
Please confirm (“YES”, “Y”; “NO”, 
>y 

CRAFT INITIATED SOCC CONTROL LIST 


CONTROLS WILL BE REMOVED! 
or “N”): 


RESET 
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ACGCNTRL commands 
RESET (continued) 


>RESET CAINO2 NONZEROCRAFT 

WARNING: ALL NON-ZEROGAP CRAFT INITIATED SOCC CONTROLS WILL 
BE REMOVED! 
Please confirm (“YES”, “Y”, “NO”, or “N”): 

>Y 

NON-ZEROGAP CRAFT INITIATED SOCC CONTROL LIST RESET 


Responses 
The following are example responses to the RESET command: 


That Application is not valid. 


Explanation: 
An attempt was made to list controls for an application that does not 
exist in table VAMPTRID. 


System action: 
None. 


User action: 
Retry the command with a valid application name. 


Please confirm (“YES”, “Y”, “NO”, or “N”): 


Explanation: 
This message is given to confirm the user’s attempt to reset a control 
list. 


System action: 
If the user answers ‘YES’ or ‘Y’ the list is reset, otherwise the 
command is rejected. 


User action: 
Type ‘YES’, ‘Y’, ‘NO’ or N’ 


Related commands 
The following commands are found in the ACGCNTRL directory: 


e ADD 

e GLOBAL 
e HELP 

e LIST 
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ACGCNTRL commands 
RESET (end) 
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CAIN tool 
CAINSCPT 
ATTENTION 
The SCP simulator requires the CAIN0300 SOC option. The 
DMS-250 switch generates a CAIN102 log if you attempt to use the 
SCP simulator without the CAIN0300 SOC option. In addition, a T1 
timeout occurs. Refer to the UCS DMS-250 Software Optionality 
Control User’s Manual for more information on UCS DMS-250 SOC. 
Purpose 


CAINSCPT is one of the testing tools available with the carrier advanced 
intelligent network (CAIN) system. CAINSCPT supports the service control 
point (SCP) simulator. The SCP simulator uses internal transaction identifier 
(TRID) tables to maintain information between conversational messages. 
These tables can become corrupted through call processing errors and 
testing. The SCP simulator has no automatic method for correcting the 
corrupted TRIDs. If all of the TRIDs are in a busy state, the SCP simulator 
responds to every query message with an abort message. The CAINSCPT 
test tool enables you to activate, idle, and display information about TRIDs. 


Use CAINSCPT to perform one of the following functions: 
e TRIDIDLE—idle the specified TRID(s) 


e TRIDINFO—display information on the specified TRID(s). If the 
TRID(s) are idle, the UCS DMS-250 switch displays only information 
on those TRID(s). If the TRID(s) are in use, the switch prints the 
information on the TRID(s) as well as the associated information kept 
with the TRIDs. 


e TRIDUSE—activate specific TRIDs by placing them “in use.” Use this 
function for testing and debugging. TRIDUSE does not allow you to 
specify any other information associated with TRID(s). 


e TIMERWHEEL—detail information associated with the SCP simulator, 
such as which TRIDs are in a specific timer slot of the timer wheel. 


WARNING 

Do not alter TRID entry while call is in conversation. 
Calls can behave strangely if the TRID entry associated 
with the call is altered while the call is in conversation. 
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CAINSCPT (continued) 
Access 
>CAINSCPT 
Syntax 
>CAINSCPT function TRID_number TRID_range all_TRIDS 
>CAINSCPT TIMERWHEEL CURRSLOT slot_number slot_range all_slots 
Parameters 


The command parameters are described in Table 1-7. 


Table 1-7 
CAINSCPT parameter descriptions 


Parameter Values Description 

function TRIDINFO Specifies which function of CAINSCPT to 
perform 

TRIDIDLE 
TRIDUSE 

all_TRIDS ALL Specifies all TRIDs 

TRID_number 0 through 99 Specifies a specific TRID identified by its 
number 

TRID_range 0 through 99 Specifies a range of TRIDs identified by 
their numbers. If the first number in to 
range is larger than the second, the 
CAINSCPT tool reverses them. 

TIMERWHEEL = =TIMERWHEEL Specifies that you want details about the 
SCP simulator’s timeout wheel 

CURRSLOT CURRSLOT Specifies the current timer slot being used 

slot_number O through 121 Specifies a specific timer slot identified by 
its number 

slot_range 0 through 121 Specifies a range of timer slots identified 
by their numbers 

all_ slots ALL Specifies all timer slots for the timerwheel 


—end— 


Example commands 


The following are example CAINSCPT command entries. 


Digital Switching Systems UCS DMS-250 Commands Reference Manual UCS17 


1-32 Commands 


CAIN tool 


CAINSCPT (continued) 


Example one 


This is an example of idling transaction identifiers (TRIDs) using the range 


specifier. 


>CAINSCPT TRIDIDLE range 5 10 


Clearing 
Clearing 
Clearing 
Clearing 
Clearing 
Clearing 


Example two 


HHHHHAH 


RID 5 
RID 
RID 
RID 
RID 
RID 


rPwoO 0 =] 


This is an example of displaying information about the TRIDs using just one 


TRID. 


>CAINSCPT TRIDINFO TRID 6 


TRID 6 IS IDLE 


Example three 


This is an example of activating TRID 10. 


>CAINSCPT TRIDUSE TRID 10 
BUSYING TRID 10 


Example four 


This is an example of identifying the current slot of the timer wheel. 


>CAINSCPT TIMERWHEEL CURRSLOT 


CURRENT TIMER WHE 


Responses 


EL: 85 


After the CAINSCPT command successfully completes, the system displays 
one of the following responses. 


Clearing TRID <num> 


Explanation: 


Occurs when you enter a TRIDIDLE function on a single TRID 


System action: 


None 


User action: 
None 
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CAINSCPT (continued) 


Invalid TRID No. <num> 


Explanation: 
Occurs when you try to perform a function on a TRID number that is 
out of range 


System action: 
None 


User action: 
None 


TRID <num> is already in an idle state 


Explanation: 
Occurs when you try to IDLE a TRID that is already in idle state 


System action: 
None 


User action: 
None 


TRID <num> is already in use 


Explanation: 
Occurs when you use the TRIDUSE function, placing a TRID in use 
that is already in use. 


TRID<num> is idle 


Explanation: 
Occurs when you enter a TRIDINFO function on a single TRID that 
is idle 


TRID <num> IS IN USE 
INVOKE ID: <num> 


CAINMTCH IDX: OUT OF RANGE 
PLAYLIST IDX: <NUM> 


DIGITS [0]: NONE 
DIGITS [1]: NONE 
DIGITS [2]: NONE 
DIGITS [3]: NONE 
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CAINSCPT (end) 
Explanation: 
Occurs when you enter a TRIDINFO function on a TRID that is in 
use. 


TRID <num> was put in use by another process 


Explanation: 
Occurs when you use the TRIDUSE command. When the command 


began to execute, the TRID was idle. However, when the code tried 
to find the idle TRID, it was unavailable. 


Related commands 
Commands related to CAINSCPT include: 
e SCP simulator 
e CAINTEST 
e VPTRACE 
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CAINTEST 


Purpose 


ATTENTION 
CAINTEST requires the CAIN0400 SOC option. Refer to the UCS 
DMS-250 Software Optionality Control User’s Manual for more 
information on UCS DMS-250 SOC. Refer to the DMS-100 Family 
Software Optionality Control User’s Manual for general SOC 
information. 


This section describes the syntax, purpose, and semantics of the CAINTEST 
commands and lists them in alphabetical order. Included with each 
command description are some of the messages that occur when the 
command is used. Commands requiring one or more parameters are 
followed by an example of the parameter list. When entering the command 
and parameters, be sure to separate each parameter by a blank space. 


Some commands have required parameters. The MAP command interpreter 
(CI) prompts for required parameters until they are entered correctly. The 
MAP CI does not prompt for optional parameters unless they are optional as 
a group and at least one optional parameter was entered. The results of some 
CAINTEST commands are altered by the absence or presence of individual 
or groups of optional parameters. These cases are fully described when 
applicable. 


This command activates CAINTEST, the Carrier Advanced Intelligent 
Network (CAIN) message query test tool. CAINTEST allows you to create 
and send test queries to the SCP. SCP queries and responses can be 
displayed for maintenance and verification purposes. 


CAUTION 

Avoid CAINTEST during high traffic periods 
CAINTEST sends actual messages (contributing to 
network traffic) to the SCP. Avoid using this command 
during high traffic periods because of the low CPU 
priority of command interpreter (CI) commands. 


Response time is diminished as busy hour call attempts 
(BHCA) increase. 
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CAINTEST tool 


CAINTEST (continued) 


CAINTEST provides the ability to 


Access 


generate queries for testing SCP interaction 

display SCP or SCP simulator responses 

automatically or manually enter into conversation with the SCP 
display, set and clear message parameters 

list parameters for any particular switch-generated message 

override the CAIN_T1_TIMEOUT parameter for a particular test query 
display command syntax 


support the maintenance and verification of the SCP or SCP simulator 


All CAINTEST commands are accessed through the following command: 


>CAINTEST 


Restrictions 


The following apply to CAINTEST: 


CAINTEST supports the messages and parameters supported in the 
UCS11 CAIN software release. 


CAINTEST is available to more than one user. The number of possible 
users is limited only by the number of MAP sessions that can be 
activated at one time. 


When a test query (single or multiple messages) is sent to the SCP, the 
display session must end before initiating another test query (single or 
multiple messages). 


CAINTEST can send multiple messages (up to 50) in one execution of 
the CAINTEST command. 


CAINTEST does not report application errors to the SCP, including 
CAIN_T1_TIMEOUT. 


CAINTEST can send only one reply message to a conversational 
package. 


Note: If you send multiple reply messages in response to a 
conversational Send_To_Resource Or Connect_To_Resource message, 
any queued conversation packages will timeout before you can read 
them. Therefore, you are restricted to one conversational response for 
every conversational Send_To_Resource Or Connect_To_Resource 
message received from the SCP. 
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CAINTEST (continued) 


e Ifyou did not build enough conversational response messages before 
sending the query, CAINTEST defaults to sending a Resource_Clear or 
CTR_Clear message. CAINTEST then prompts you for parameter data 
before sending the response. 


For more information on CAIN and CAINTEST, refer to the UCS DMS-250 
NetworkBuilder Application Guide. 


Syntax 
>COMMAND 


Parameters 
None 


Example command 
>CAINTEST 


Responses 
None 


Related commands 
The following commands are accessible through CAINTEST: 


e CLRPARM 
e HELP 

e LISTPARM 
e QUIT 

e RESPORD 
e SEND 

e  SETAPPL 

e SETFAM 

e SETMSG 

e SETPARM 
e SETQUERY 
e SETRESP 

e SETTRANS 
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CAINTEST tool 
CAINTEST (end) 


e SHOWFLDS 
e TIMEOUT 
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CLRPARM 


Purpose 


Access 


Syntax 


Parameters 


The Clear Parameter (CLRPARM) command allows you to clear the value 
of one or all parameters associated with the active message. When you clear 
the value of a parameter, it will not be sent. 


>CAINTEST 


>CLRPARM <parm_type> <parm_name> 
>CLRPARM STD parameter 
>CLRPARM EXT parameter 
>CLRPARM ALL 


Command parameters are described in Table 1-8 and Table 1-9. 


Note: CAINTEST does not allow you to clear a standard parameter until the 
message type is set. CAINTEST does not allow you to clear an extension 
parameter until the family type and message type are set. 
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CLRPARM (continued) 


Table 1-8 
STD parameter descriptions 
Parameter Values Description 
parameter Name of parameter Indicates the actual parameter to be cleared that is 
as follows: associated with the active message: 
Access AccessCode 
AMP1 AMP1 
Bearcap BearerCapability 
Busycse BusyCause 
Carrier Carrier 
CcID CallConfigurationID 
Chgno ChargeNumber 
ChgPtyStn ChargePartyStationType 
Cldno CalledPartyID 
Clearcse ClearCause 
ClrCseDt ClearCauseData 
Clgno CallingPartyID 
Closecse CloseCause 
Colladdr CollectedAddressInfo 
Colldigs CollectedDigits 
ConnTime ConnectTime 
EchoData EchoData 
Failcse FailureCause 
FeatID FeatureActivatorID 
IPReturnBlock IPReturnBlock 
JIP JurisdictionInformation 
LegID LegID 
Notifind NotificationIndicator 
PIC PointInCall 
STRConn STRConnection 
Termind TerminationIndicator 
Trigcrit TriggerCriteriaType 
UserID UserID 
VertServ VerticalServiceCode 
Lata Lata 
Station Station 
—end— 
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CAINTEST commands 
CLRPARM (continued) 


Table 1-9 
EXT parameter descriptions 
Parameter Values Description 
parameter Name of parameter as Indicates the actual parameter to be set that is 
follows: associated with the active message 
busyRte busyRoute 
univAcc universalAccess 
cainGrp cainGroup 
adin adin 
orig Trk orig TrunkInfo 
treatmt treatment 
reorig reorigCall 
termTrk termTrunkInfo 
univldx univldx 
netinfo netinfo 
tlovil t1 Overflow 
InpRevd InpReceived 
subinfo subscriptioninfo 
cainPRT cainPretranslator 
connTime connectTime 
numReorig numReorig 
jip jurisdictionInformation 
colladdr collectedAddress 
swid switchID 
billnum billingNumber 
acctcode accountCode 
PIN pinDigits 
—end— 


Example command 
>CLRPARM ALL 
>CLRPARM CLGNO 


Responses 


If CLRPARM ALL is entered, the values of all the parameters that have 
been specified are cleared. The following example shows the response to 
CLRPARM ALL when used in conjunction with the SHOWFLDS 
command: 


>SHOWFLDS ALL 
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CLRPARM (continued) 


APPLICATION CAINO2 

TRANSPORT TCAP_SCCP CAIN_CLID_GT 31 

MESSAGE: INFO_ANALYZED 

TIMEOUT: 3 

PARMS: CLDNO: NATL 2145323773 
CLGNO: NATL 2143562784 
CHGNO: NATL 2143562784 


>CLRPARM ALL 


>SHOWFLDS ALL 

APPLICATION CAINO2 

TRANSPOR TCAP_SCCP CAIN_CLID_GT 31 
MESSAGE: INFO_ANALY ZED 

TIMEOUT: 3 


The following is an example response for the CLRPARM command when 
clearing an extension parameter. CAINTEST does not allow you to clear an 
extension parameter until the family type and message type are set. In the 
example, the family type and message type are set, however, an invalid 
extension parameter is entered. When an invalid extension parameter is 
entered, the list of valid extension parameters displays. 


>SETTRANS tcap_sccp CAIN_CLID_GT 214 
>SETMSG INFO_ANALYZED 


>SHOWFLDS 
QUERY 1 
APPLICATION :CAIN02 
TIMEOUT ¿30 sec 
FAMILY :DMS250 
MESSAGE : INFO_ANALY ZED 
CHGNO :NATL2145323773 
CLGNO :NATL2143562784 
BILLNUM :NATL2143562784 
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CAINTEST commands 
CLRPARM (continued) 


>CLRPARM EXT KJHKJ 


Invalid symbol: <Parameters:> 


Enter: <Parameters:> 
>BILLNUM 
>SHOWFLDS 
QUERY 1 
APPLICATION :CAINO2 
TIMEOUT 230 sec 
FAMILY :DMS250 
MESSAGE : INFO_ANALYZED 
CHGNO :NATL2145323773 
CLGNO :NATL2143562784 


{Univacc, 
Caingrp, 
Adin, 
Origerk, 
Termtrk, 
Busyrte, 
Treatmt, 
Reorig, 
Unividx, 
Tlovfl, 
Lnprcvd, 
Netinfo, 
Subinfo 
CainPRT, 
connTime, 
numReorig, 
JIP, 
Colladdr, 
Swid, 
Billnum, 
Acctcode, 
PIN} 


Note: CAINTEST does allow you to use the CLRPARM command on 
parameters that are not valid with the TERMINATION_NOTIFICATION 


message. 


The following are examples of using the CLRPARM command to clear a 
valid parameter and an invalid parameter associated with the 
TERMINATION_NOTIFICATION message. 
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CAINTEST commands 
CLRPARM (continued) 


Example: Clearing a valid parameter 


>SETRESP 1 
>SETMSG TERMINATION_NOTIFICATION 
>SETPARM STD CONNTIME 2 29 0 


>SHOWFLDS 

APPLICATION :CAINO2 

TIMEOUT :30 sec 

FAMILY :DMS250 

MESSAGE : TERMINATION NOTIFICATION 
CONNTIME : 00002:29:0 

>CLRPARM STD CONNTIME 

>SHOWFLDS 

APPLICATION :CAINO2 

TIMEOUT “30 sec 

FAMILY :DMS250 

MESSAGE : TERMINATION NOTIFICATION 


Example: Clearing an invalid parameter 


>SETRESP 1 
>SETMSG TERMINATION_NOTIFICATION 
>SETPARM STD CONNTIME 2 29 0 


>SHOWFLDS 

APPLICATION :CAINO2 

TIMEOUT £30 sec 

FAMILY :DMS250 

MESSAGE :TERMINATION_NOTIFICATION 
CONNTIME : 00002:29:0 

>CLRPARM STD CLOSECSE 


Invalid standard parameter for the existing caintest message. 
Operation executed anyway. 


Error messages 


The following error messages may display on entry of the CLRPARM 
command: 


All parameters are empty. 
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CAINTEST commands 
CLRPARM (continued) 


Explanation: 
User tried to clear all parameters when all parameters are empty. 


System action: 
The system aborts the command and displays the response. 
Message type is not set. 


Explanation: 
User tried to clear one or all parameters when the message type is not 
set. 


System action: 
The system aborts the command and displays valid message entries. 
Parameter type is not set. 


Explanation: 
User tried to clear a parameter that CAINTEST did recognize as 
valid, but was not datafilled for the active message. 


System action: 
The system aborts the command and displays the response. 


Message is not present 
Explanation: 
User tried to clear a parameter but the query message is not present. 


System action: 
The system aborts the command and displays an error message. 


User action: 
The user must enter the query message value. 


Family is not present 


Explanation: 
User tried to clear an extension parameter but the query family is not 
present. 


System action: 
The system aborts the command and displays an error message. 
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CAINTEST commands 
CLRPARM (end) 


User action: 


The user must enter the extension parameter family value. 


Related commands 


The following commands are accessible through CAINTEST: 


e HELP 
e LISTPARM 
e QUIT 

e RESPORD 

e SEND 

e  SETAPPL 

e SETFAM 

e SETMSG 

e SETPARM 

e SETQUERY 
e SETRESP 

e SETTRANS 
e SHOWFLDS 
e TIMEOUT 
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CAINTEST commands 
HELP 


Purpose 


Access 


Syntax 


Parameters 


Table 1-10 


The Help (HELP) command assists you with using the CAINTEST tool, the 
syntax of CAINTEST commands, and parameter values. 


>CAINTEST 


>HELP 
or 
>HELP <parm_name> 


Command parameters are described in Table 1-10. 


HELP parameter descriptions 


Parameter 


Values Description 


<parm_name> 


Name of parameter Displays the syntax and parameters for this 
as follows: command 


CLRPARM 
HELP 
LISTPARM 
QUIT 
RESPORD 
SEND 
SETAPPL 
SETFAM 
SETMSG 
SETPARM 
SETQUERY, 
SETRESP 
SETTRANS 
SHOWFLDS 
TIMEOUT 


—end— 
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CAINTEST commands 
HELP (continued) 


Example command 


Responses 


>HELP CLRPARM 


The following is an example of the response to the HELP command when 
no parameter is specified: 


>HELP 
Next par is <Fields> {Caintest, 
CLRPARM, 
HELP, 
LISTPARM, 
SEND, 
SETAPPL, 
SETMSG, 
SETPARM, 
SETTRANS, 
HOWF LDS, 
IMEOUT, 
ETFAM, 
ETRESP, 
ESPORD, 
ETQUERY, 
UIT} 


n 


OnDNNH 


The following is an example of the response to the HELP command when a 
parameter is specified: 


>HELP CLRPARM 

Clrparm : Clears a/all parameter(s). 
Parms: <Fields: > {Std <Standard> {Userid 
Bearcap, 
CcID 
LegID 


LATA}, 
{Ext <Extension> {busyRte, 
se get 


Error messages 


The following error messages may display as a result of the HELP 
command: 
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CAINTEST commands 


HELP (end) 


Invalid symbol. 


Explanation: 


The user tried to retrieve information on an unknown topic. The 


system lists the valid parameter entries. 


User action: 
Change the value to a valid parameter. 


Related commands 


The following commands are accessible through CAINTEST: 


CLRPARM 
LISTPARM 
QUIT 
RESPORD 
SEND 
SETAPPL 
SETFAM 
SETMSG 
SETPARM 
SETQUERY 
SETRESP 
SETTRANS 
SHOWFLDS 
TIMEOUT 
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CAINTEST commands 
LISTPARM 


Purpose 


The List Parameter (LISTPARM) command displays all parameters that are 
valid for the current message. If you do not specify a value for this 
command, the parameters of the current message are displayed. If there is no 
message present and you do not enter a value, the command syntax is 


displayed. 
Access 

>CAINTEST 
Syntax 

>LISTPARM 

or 

>LISTPARM <msg_name> 

Parameters 


Table 1-11 shows a list of valid messages that are displayed when the 
LISTPARM command is used and no message has been set. 
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CAINTEST commands 
LISTPARM (continued) 


Table 1-11 


LISTPARM message descriptions 


Parameter 


Values 


Description 


<msg_name> 


Valid values include: 
Origination_Attempt 
O_Feature_Requested 
Info_ Collected 
Info_Analyzed 
Network_Busy 
O_Called_Party_Busy 
O_No_Answer 
Resource_ Clear 
Close 
Application_Error 
Return_result 
O_Term_Seized 
O_Answer 
O_Mid_Call 
CTR_Clear 

Timeout 

O_ Disconnect 


Termination _Attempt 


Call_Info_From_Resource 


Termination_Notification 
ACG_Overflow 

Start 

Failure_Outcome 
OAbandon 


Displays a list of valid messages. 
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CAINTEST commands 
LISTPARM (continued) 


Example command 
>LISTPARM 
>LISTPARM Failure Outcome 


Responses 


If no value for this command is specified and no message has been set, the 
command syntax displays. The following is an example of the response to 
the LISTPARM command when no message has been set: 


>LISTPARM 


The message is not set. 

Listparm : List parameters for a specific message. 

Parms: [<Fields> {Info_Analyzed, 
Info_Collected, 
Network_Busy, 
O_Called_Party_Busy, 
O_Feature_Requested, 
O_No_Answer, 
Origination_Attempt, 
Termination_Attempt, 
O_Mid_Call, 
Start, 
Resource_Clear, 
Application_Error, 
Close, 
Return_result, 
O_Term_Seized, 
O_Answer, 
O_Disconnect, 
Timeout, 
Call_Info_From_Resource, 
CTR_Clear 
Termination_Notification, 
ACG_Overflow, 
Failure_Outcome 
OAbandon} ] 


All parameters that are associated with this command are optional. If a 
parameter is entered incorrectly, CAINTEST will not offer a description of 
the optional parameter values. The following is an example of a response to 
the LISTPARM command when a message is present: 
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LISTPARM (continued) 


>LISTPARM Failure_Outcome 


Listparm: List parameters for a FAILURE_OUTCOME message. 
Parms: <Fields> {FAILURE_OUTCOME <FAILURE_OUTCOME> 

{Userid, 

Bearcap, 

CCID; 

LegID, 

PointInCall, 

FailureCause, 

ExtensionParameter...}} 
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LISTPARM (continued) 


The following is an example of a response to the LISTPARM command for 
the Info_Analyzed message. 


>LISTPARM Info_Analyzed 


Listparm: Lists all parameters associated with the 
Info_Analyzed message 
Parms: <Standard: > {Userid, 
Bearcap 
Cldno, 
Lata 
Carrier 
LRIgerre,; 
Chgno, 
Clgno, 
ChgPtyStn, 
Carrier, 
Access, 
Colladdr, 
Colldigs, 
Vertserv, 
ACGENC, 
AMP 1 
JIP} 
<Extension:>{Univacc, 
Caingrp, 
Adin, 
Origtrk, 
Treatmt, 
Reorig, 
UnivIdx, 
LnpRcvd, 
Netinfo, 
Swid, 
Billnum, 
Acctcode, 
Pindigs 
ACGRequery } 


Related commands 
The following commands are accessible through CAINTEST: 


e CLRPARM 
e HELP 
e LISTPARM 
e QUIT 
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LISTPARM (end) 


RESPORD 
SEND 
SETAPPL 
SETFAM 
SETMSG 
SETPARM 
SETQUERY 
SETRESP 
SETTRANS 
SHOWFLDS 
TIMEOUT 
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QUIT (end) 
Purpose 
QUIT (Quit) exits the CAINTEST tool and returns to the command 
interpreter (CI:) prompt. 
Access 
>CAINTEST 
Syntax 
>QUIT 
Parameters 
None 


Example command 
> QUIT 


Responses 
The system returns to the CI: prompt. 


Related commands 
The following commands are accessible through CAINTEST: 


e CLRPARM 
e HELP 

e LISTPARM 
e RESPORD 

e SEND 

e  SETAPPL 

e SETFAM 

e SETMSG 

e SETPARM 

e SETQUERY 
e SETRESP 

e SETTRANS 
e SHOWFLDS 
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RESPORD 
Purpose 
RESPORD (Response Order) sets the order in which CAINTEST sends a 
response to the SCP. 
Access 
>CAINTEST 
Syntax 
>RESPORD order# 
Parameters 
Command parameters are described in Table 1-12. 
Table 1-12 


RESPORD parameter 


Parameter Values Description 
order# 1to3 Indicates the number of the response 
—end— 


Example command 
>RESPORD 1 


Responses 
None 


Related commands 
The following commands are accessible through CAINTEST: 


e CLRPARM 
e HELP 

e LISTPARM 
e QUIT 

e SEND 

e  SETAPPL 

e SETFAM 
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RESPORD (end) 


e SETMSG 

e SETPARM 

e SETQUERY 
e SETRESP 

e SETTRANS 

e SHOWFLDS 
e TIMEOUT 


297-2621-819 Standard 14.01 April 2002 


Commands 1-59 


CAINTEST commands 
SEND 


Purpose 


The Send (SEND) command allows you to send an AIN 0.2 message to the 
service control point (SCP). 


To send a valid message, the following must be set: 


application (SETAPPL) 

transport medium (SETTRANS) 
family (SETFAM) 

message (SETMSG) 

all mandatory parameters (SETPARM) 


After using the SEND command, you may not be allowed to send another 
message with this command until a response is received from the service 
control point (SCP). 


The following rules apply to the SEND command: 


When you use the SEND command without any parameters, Query #1 is 
sent to the SCP one time, unless CAINTEST is in conversation. If 
CAINTEST is in conversation, then Response #1 is sent. 


When you enter SEND QUERY, without any additional parameters, 
Query #1 is sent to the SCP one time. 


If only one message has been set and the SETQUERY command was not 
used; by default, the active query will be QUERY #1. 


Query messages cannot be sent while CAINTEST is in conversation, or 
once the initial query has been sent to initiate the conversation. 


For regular query/response processing, if different multiple queries are to 
be sent, all responses for one query must be received before another 
query can be sent. 


Once the final response is received (in response to a query), the “active” 
query defaults back to QUERY #1. If, for instance, QUERY# 2 is sent 
and a response is received, when an additional SEND command is 
issued, QUERY message #1 is sent. 


When you enter SEND RESPONSE, Response #1 is sent to the SCP. 


Response messages cannot be sent unless CAINTEST is in conversation 
with the SCP. Conversation indicates that a query was sent to the SCP 
and the SCP returned the response in a conversation package. The SCP 
is, therefore, waiting for another message from CAINTEST. 
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SEND (continued) 


e When you use the SEND command, the replied message will display 
with the available parameters. Only valid parameters defined int he 
Bellcore GR—1299-CORE document will display. 


e When you enter SEND QUERY 2, Query #2 is sent to the SCP one time. 


e When you enter SEND RESPONSE 2, Response #2 is sent to the SCP, 
but only if CAINTEST is in conversation with the SCP. 


e When you enter SEND QUERY 2 10, Query #2 is sent to the SCP ten 


times. 

Access 

>CAINTEST 
Syntax 

>SEND QUERY query# #_of_times 

>SEND RESPONSE response# 
Parameters 

Command parameters are described in Table 1-13. 
Table 1-13 


SEND parameter descriptions 


Parameter Values Description 

<fields> UNCHANGED indicates which message to send 

query# 1to3 Indicates the query number 

#_of_times 1 to 50 Number of times CAINTEST sends the message 
to the SCP 

response# 1to3 Indicates the response number 


Example commands 
>SEND QUERY 1 1 
>SEND RESPONSE 2 
Responses 
The following is an example of the response to the SEND command. 


>SEND QUERY 1 1 


Message sent, waiting for reply. 


297-2621-819 Standard 14.01 April 2002 


Commands 1-61 


CAINTEST commands 


SEND (continued) 


SCP-returned message data 


This section shows the responses received after the message is sent. 


Successful responses 


The following shows a successful response, where the SCP returned an 


Analyze_Route message. 


>setappl cain02 

>settrans tcap_sccp cain_addr_gt 801 
>setfam dms250 

>setmsg info_analyzed 

>timeout 5 

>setparm std userid trk 12 

>setparm std bearcap speech 
>setparm std trigcrit cust_int 
>setparm std cldno natl 2731200 


>showflds 
QUERY iL. 
APPLICATION :CAINO2 
TRANSPORT : TCAP_SCCP CAIN_ADDR_GT 
TIMEOUT 25 sec 
FAMILY :DMS250 
MESSAGE : INFO_ANALYZED 
USERID : TRK 12 
BEARCAP : SPEECH 
CLDNO :NATL 2731200 
TRIGCRIT :CUST_INT 


>send query 1 

Message sent. 

TIME--> Received response in 0.28 sec 
Conversation mode between SSP and SCP. 
ANALYZED_ROUTE received 


CHGNO : AUTH 6113311 

PRITRK :opls=Y swid=11 trkgrp=220 
OPULSNO : SUBR 2144567 

AMASLPID 2123456789 

BILLNUM :MCCS 9876543210 
ACCTCODE :NATL 9723456789 

PIN : ACCT 3144567 


Mailbox deallocated. 


801 
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SEND (continued) 


The following shows a successful response, where the SCP returned an 
Analyze_Route message. In this response message, the AMALineNumber and 
the AMAA1ternateBillingNumber parameters are supported. 


>setappl cain02 

>settrans tcap_sccp cain_ofcd_gt 214 
>setfam dms250 

>setmsg info_analyzed 

>timeout 30 

>setparm std cldno natl 2145323773 
>setparm std chgptyst 00 

>setparm std chgno natl 2143562784 
>setparm std bearcap 3_1kHz 
>setparm std userid dn 2143562784 
>setparm std trigcrit Inp_ofcd 


>showflds 
>SHOWF LDS 
Appl: cain02 
Trans: tcap_sccp cain_ofcd_gt 214 
Msg: info_analyzed 
Timeout: 30 sec 
C1dNo:Natl 2145323773 
ChgPtySt:00 
ChgNo:Natl 2143562784 
BearCap:3_1kHz 
UserID: DN 2143562784 
TrigCrit: LNP_OFCD 
>SEND 1 


Message sent, waiting for reply 
TIME--> RECEIVED SCP RESPONSE IN 5.9 SECONDS 
Analyze_route -- Continue call under the direction of the SCP 


C1dNo :Natl 2147775678 
ABCDEFGHIJKLMNO 

FCI 700000000000010 0 

PortedNo:Natl 2145323773 

AMALNNUM:006 2146113311 

AMAABNUM: 2145112211 
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SEND (continued) 


The following shows a successful response, where the SCP returned an 
Originate_Call message. 


>send 
Message sent 
TIME > Received response in 0.13 sec 


Continue call under the direction of the SCP. 
Originate_Call received 

CLGNO : NATL 2146112211 
Mailbox deallocated. 


A similar response is shown where the SCP returns the following messages: 
Merge_Call, Disconnect_Leg, Acknowledge, Collect_Information, 
Send_To_Resource, Connect_To_Resource, Call_Info_To_Resource, 
Continue, Or Authorize_Termination. 


The following shows a successful response, where the SCP returned a 
non-call related message, Send_Notification. 


Message sent, waiting for reply 
TIME --> RECEIVED SCP RESPONSE IN 5.9 SECONDS 


Send_Notification -- A request for notification has been 
issued. 
PARMS: ECHODATA: 


The following shows a successful response, where the SCP/Simulator 
returned an Automatic Code Gapping (ACG) message containing an ACG 
control. 


>send 
Message sent 
TIME > Received response in 0.13 sec 


Continue call under the direction of the SCP. 


ACG received 


CCI: 10 digit SCP 
DURATION: 64 sec 

GAP: 0.10 sec 

TT: CAIN_ADDR_GT 
GTA: 2146840000 


Mailbox deallocated. 
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CAINTEST commands 
SEND (continued) 


The following responses may display as a result of the SEND command. 


Error responses 
An error response displays if: 


* no answer is received from the SCP within the given time-out period 
specified by the value of T1 timer (the default value is 3 seconds) 


e an erroneous query has been sent 

e a corrupted response is received from the SCP 

e the user did not reply with a conversation request message from the SCP 
within the time-out period 


Error messages 


The following error messages may display as a result of the SEND 
command. 


Missing application parameter 


Explanation: 
User tried to send a message to the SCP with the application field 
missing. 


System action: 
The system suspends the command and waits for a response. 


User action: 
Use the SETAPPL command. 


Missing message parameter 


Explanation: 
User tried to send a message to the SCP with the message field 
missing. 


System action: 
The system suspends the command and waits for a response. 


User action: 
Use the SETMSG command. 
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SEND (continued) 


Missing transaction id 


Explanation: 
The query was not issued a transaction ID because the AIN system 
ran out of transaction IDs. 


User action: 
Datafill table VAMPTRID. 
Missing transport medium parameter 


Explanation: 
User tried to send a message to the SCP with the transport medium 
field missing. 


System action: 
The system suspends the command and waits for a response. 


User action: 
Use the SETTRANS command. 
Received invalid SCP response, abort sent 


Explanation: 
An abort command was sent to the SCP because an invalid message 
was received from the SCP. 


System action: 
The system aborts the command. 
Received invalid SCP response, reject sent 


Explanation: 
A reject command was sent to the SCP because an invalid message 
was received from the SCP. 


System action: 
The system aborts the command. 


Received network error message 
Explanation: 
Message could not be sent. 


System action: 
System aborts the command. 
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SEND (continued) 


Subsystem out of service 
Explanation: 
The subsystem is out of service. 


User action: 
Utilize CCS7/SCCP map level to verify subsystem status. 


T1 timer expired 


Explanation: 
A response from the SCP was not received before the T1 timer 
expired. 


System action: 
The system aborts the command. 


Unknown error 


Explanation: 
CAINTEST received an error message from the SCP that it did not 
recognize. 


Related commands 
The following CAINTEST commands are related: 


e CLRPARM 
e HELP 

e LISTPARM 
e QUIT 

e RESPORD 
e  SETAPPL 

e SETFAM 

e SETMSG 

e SETPARM 
e SETQUERY 
e SETRESP 

e SETTRANS 
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SEND (end) 


e SHOWFLDS 
e TIMEOUT 
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SETAPPL 
Purpose 
SETAPPL (Set Application) selects the application(s) tested with the 
CAINTEST utility. 
Access 
>CAINTEST 
Syntax 
>SETAPPL applications 
Parameters 
Command parameters are described in Table 1-14. 
Table 1-14 


SETAPPL parameter description 


Parameter Values Description 
applications CAINO2, IN1 Indicates the application selected for the test 
query. 
—end— 


Example command 
>SETAPPL CAINO2 


Responses 


If no values are specified for this command, the command syntax displays. 
The following is an example response to the SETAPPL command when an 
incorrect and then a correct application is specified: 


>SETAPPL KJHKJ 
Next par is: <Applications> {CAINO2} 
Enter: <Applications> 


>CAINO2 


Related commands 
The following commands are accessible through CAINTEST: 


e CLRPARM 
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SETAPPL (end) 


HELP 
LISTPARM 
QUIT 
RESPORD 
SEND 
SETFAM 
SETMSG 
SETPARM 
SETQUERY 
SETRESP 
SETTRANS 
SHOWFLDS 
TIMEOUT 
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SETFAM 


Purpose 


SETFAM (Set Family) selects the Nortel (NT) products tested with the 
CAINTEST utility. 


Note: The UCS DMS-250 is the only product supported. 


Access 
>CAINTEST 
Syntax 
>SETFAM family 
Parameters 
Command parameters are described in Table 1-15. 
Table 1-15 
SETAPPL parameter description 
Parameter Values Description 
family DMS250 DMS250 is the set of extension parameters 


currently available 


—end— 


Example command 
>SETFAM DMS250 


Responses 


If no values are specified for this command, the command syntax displays. 
The following is an example response to the SETAPPL command with an 
incorrect application specified and then the correct application specified: 


>SETFAM KJHKJ 
Next par is: <Family> {DMS250} 
Enter: <Family> 


>DMS250 
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SETFAM (end) 


Related commands 
The following commands are accessible through CAINTEST: 


e CLRPARM 
e HELP 

e LISTPARM 
e QUIT 

e RESPORD 

e SEND 

e  SETAPPL 

e SETMSG 

e SETPARM 

e SETQUERY 
e SETRESP 

e SETTRANS 
e SHOWFLDS 
e TIMEOUT 
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SETMSG 


Purpose 


The Set Message (SETMSG) command allows you to populate the message 
parameter for a particular message. You can specify the AIN 0.2 message 
sent for the current query or response. If you do not enter a valid value, the 
command syntax displays 


Access 

>CAINTEST 
Syntax 

>SETMSG <message_name> 
Parameters 


Command parameters are described in Table 1-16. 
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CAINTEST commands 
SETMSG (continued) 


Table 1-16 
SETMSG parameter descriptions 


Parameter Values 


Description 


<message_name> Valid values include: 
Origination_Attempt 
O_Feature_Requested 
Info_ Collected 
Info_Analyzed 
Network_Busy 
O_Called_Party_Busy 
O_No_Answer 
Resource_Clear 
Close 
Application_Error 
Return_result 
O_Term_Seized 
O_Answer 
O_Mid_Call 
CTR_Clear 

Timeout 
O_Disconnect 


Termination_Attempt 


Call_Info_From_Resource 


Termination_Notification 
ACG_Overflow 

Start 

Failure_ Outcome 
OAbandon 


Specifies the messages sent as the 
current query. 


—end— 
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SETMSG (continued) 


Example commands 


Responses 


>SETMSG termination_notification 
>SETMSG network_busy 
>HELP SETMSG 


The following is an example response to the SETMSG command with a 
correct parameter specified: 


>SETRESP 1 

>SETMSG TERMINATION_NOTIFICATION 
>SHOWFLDS 

APPLICATION : CAINO2 

TIMEOUT : 30 sec 

FAMILY : DMS250 

MESSAGE : TERMINATION _NOTIFICATION 


If no values are specified for this command, the command syntax displays. 


The following are example responses to the SETMSG command with 
incorrect parameters specified: 


>SETQUERY 1 

>SETMSG JHGJH 

Invalid symbol: <Messages> {Info_Analyzed, 
Info_Collected, 
Network_Busy, 
O_Called_Party_Busy, 
O_Feature_Requested, 
O_No_Answer, 
Origination_Attempt, 
Termination_Attempt, 
O_Mid_Call, 
CTR_Clear} 


Enter: <Messages> 
>SETMSG O_Mid_Call 
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SETMSG (continued) 


>SETRESP 1 
>SETMSG JHGJH 


Invalid symbol: <Messages> {Resource_Clear, 


Enter: <Messages> 
>SETMSG Resource_Clear 


Application_Error, 
Close, 

Return_result, 
Network_Busy, 
O_Called_Party_Busy, 
O_No_Answer, 
O_Term_seized, 

O_Answer, 

O_Disconnect, 

Timeout, 
Call_Info_From_Resource, 
CTR_Clear, 
Termination_Notification, 
ACG_Overflow, 
O_Mid_Call, 
Failure_Outcome, 
O_Abandon } 
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SETMSG (continued) 


The following is an example response to the SETMSG command when Help 
is used to set fields and message types for the O_IEC_Reorigination trigger. 


>HELP SETMSG 
>SETMSG -- Specifies AINO2 message 
Parms: <Messages> {Info_Analyzed, 


Info_Collected, 
Network_Busy, 
O_Called_Party_Busy, 
O_Feature_Requested, 
O_No_Answer, 
Origination_Attempt, 
Termination_Attempt, 
O_Mid_Call, 
Resource_Clear, 
Close, 
Application_Error, 
Return_result, 
O_Term_Seized, 
O_Answer, 
O_Disconnect, 
Timeout, 
Termination_Notification, 
Call_Info_From_Resource, 
CTR_Clear, 
Failure_Outcome, 
O_Abandon } 


Enter: <Messages> 
>SETMSG O_Mid_Call 


Related commands 
The following commands are accessible through CAINTEST: 


e CLRPARM 
e HELP 

e LISTPARM 
e QUIT 

e RESPORD 

e SEND 

e  SETAPPL 

e SETFAM 
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CAINTEST commands 
SETMSG (end) 


SETPARM 
SETQUERY 
SETRESP 
SETTRANS 
SHOWFLDS 
TIMEOUT 
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CAINTEST commands 


SETPARM 


Purpose 


Access 


Syntax 


Parameters 


Table 1-17 
STD parameters 


The Set Parameter (SETPARM) command allows you to populate the 
message parameters for a particular message. You can specify the AIN 0.2 
message sent for the current query or response. If you do not enter a valid 
value, the command syntax displays. Also, included is the USERID privfac 
encoding type and the AMP1 parameter. 


>CAINTEST 


>SETPARM <parm_type> <parm_name> <parm_value> 
>SETPARM STD parameter parm_value 
>SETPARM EXT parameter parm_value 


Note: A message type must be specified. The following commands must be 
used before the SETPARM command is used. 


— SETMSG (sets the message) 


Command parameters are described in Table 1-17 and 1-18. 


Note: CAINTEST does not allow population of a standard parameter until 
the message type is present. CAINTEST does not allow population of an 
extension parameter until the family type and message type are set. 


Parameter 


Values Description 
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SETPARM (continued) 


Table 1-17 


STD parameters (continued) 


parameter 


Name of parameter 
as follows: 


Access 
ACGEnc 
AMP1 
Applerr 
Bearcap 
Busycse 
Carrier 
CCl 

CcID 
Chgno 
ChgPtySin 
Cldno 
Clearcse 
ClirCseDt 
Clgno 
Closecse 
Colladdr 
Colldigs 
ConnTime 
EchoData 
Failcse 
FeatID 
GTA 
IPReturnBlock 
JIP 

LegID 
Notifind 
Origstat 
PIC 
STRConn 
Termind 
Trigcrit 
TT 
UserID 
VertServ 
Lata 
Station 


Indicates the actual parameter to be set that is 
associated with the active message: 


AccessCode 
ACGEnc 

AMP1 

Applerr 
BearerCapability 
BusyCause 

Carrier 

CCl 
CallConfiguration|D 
ChargeNumber 
ChargePartyStationType 
CalledPartyID 
ClearCause 
ClearCauseData 
CallingPartyID 
CloseCause 
CollectedAddressInfo 
CollectedDigits 
ConnectTime 
EchoData 
FailureCause 
FeatureActivatorID 


GTA 

IPReturnBlock 
JurisdictionInformation 
LegID 
NotificationIndicator 
Origstat 

PointInCall 
STRConnection 
TerminationI|Indicator 
TriggerCriteriaType 
TT 

UserID 
VerticalServiceCode 
Lata 

Station 


Digital Switching Systems UCS DMS-250 Commands Reference Manual UCS17 


1-80 Commands 


CAINTEST commands 
SETPARM (continued) 


Table 1-18 
EXT parameters 
Parameter Values Description 
parameter Name of parameter Indicates the actual parameter to be set that is 
as follows: associated with the active message 
busyRte busyRoute 
univAcc universalAccess 
cainGrp cainGroup 
adin adin 
orig Trk orig Trunklnfo 
treatmt treatment 
reorig reorigCall 
termTrk termTrunklnfo 
unividx unividx 
netinfo netInfo 
tlovfl t1 Overflow 
InpRevd InpReceived 
subinfo subscriptioninfo 
cainPRT cainPretranslator 
connTime connectTime 
numReorig numReorig 
jip jurisdictionInformation 
colladdr collectedAddress 
swid switchID 
billnum billingNumber 
acctcode accountCode 
PIN pinDigits 
—end— 


Example command 


>SETPARM STD IMT871c7Ip00 
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SETPARM (continued) 


Responses 


The following is an example response for the SETPARM command using 
SETMSG to identify the message type. 


>SETMSG INFO_ANALYZED 
>SETPARM STD USERID CAIN 
Next paris: <origgrp> STRING 
Enter: <origgrp> <origswid> 
>IMT871C7LP00 

Next par is: <origswid> {0 TO 999} 
Enter: <origswid> 


>999 
>SHOWFLDS 
QUERY I 

APPLICATION :CAIN02 
TIMEOUT :30 sec 
FAMILY :DMS250 
MESSAGE : INFO_ANALY ZED 

USERID :CAIN IMT871C7LP00 1820 999 


If no values are specified for this command, the command syntax displays. 


If an error message for a parameter that is listed in the parameter definition 
displays, the parameter does not correspond with the message type. 


Explanation: 

The response shows an example of using the SETPARM command to 
set the USERID parameter. Note that the valid ORIGSWID 
parameter (Switch ID) range has been increased from {0-127} to 
{0-999}. 


System action: 
The USERID parameter now contains the trunk group and switch ID. 


User action: 
The user must specify a value within the range {0-999} for the 
ORIGSWID parameter. 
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CAINTEST commands 
SETPARM (continued) 


The following is an example response for the SETPARM command when 
populating an extension parameter. CAINTEST does not allow you to 
populate an extension parameter until the family type and message type are 
present. 


Example of invalid parameter: 


>SHOWFLDS 
QUERY J 
APPLICATION :CAIN02 
TRANSPORT :TCAP_SCCP CAIN_ADDR_GT 801 
TIMEOUT 230 sec 
FAMILY :DMS250 
MESSAGE : INFO_ANALY ZED 


>SETPARM EXT BILLNUM 23R 
Invalid symbol: <Nature_of_Address> (Natl, 
Intl, 
Acct, 
Ani, 
I2ani, 
Auth, 
Hotl, 
Mccs, 
Pin, 
Vpn, 
NOO, 
Part, 


Unknown) 
Enter: <Nature_of_Address> <Digits> 
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SETPARM (continued) 


Example of valid parameter: 


>SHOWFLDS 


QUERY 


APPLICATION 
TRANSPORT 
TIMEOUT 
FAMILY 
MESSAGE 
CHGNO 
CLGNO 


:CAINO2 

: TCAP_SCCP 

230 sec 
:DMS250 

: INFO_ANALY ZED 
:NATL2145323773 
:NATL2143562784 


CAIN_ADDR_GT 


>SETPARM EXT BILLNUM NATL 2143562784 


>SHOWFLDS 
QUERY 


APPLICATION 
TRANSPORT 
TIMEOUT 
FAMILY 
MESSAGE 
CHGNO 
CLGNO 
BILLNUM 


Error messages 


:CAINO2 

: TCAP_SCCP 

230 sec 
:DMS250 

: INFO_ANALY ZED 
:NATL2145323773 
:NATL2143562784 
:NATL2143562784 


CAIN_ADDR_GT 


801 


801 


The following error messages can display as a result of the SETPARM 


command: 


Message type is not set 


Explanation: 


User tried to assign a value to a parameter without declaring a 
message type. 


System action: 
The system aborts the command and displays valid message entries. 


Message is not present 


Explanation: 


User tried to set a standard parameter but the query message is not 


present. 
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CAINTEST commands 


SETPARM (end) 


Family is not present 


System action: 


The system aborts the command and displays an error message. 


User action: 


The user must enter the query message value. 


Explanation: 


User tried to set an extension parameter but the query family is not 


present. 


System action: 


The system aborts the command and displays an error message. 


User action: 


The user must enter the extension parameter family value. 


Related commands 


The following commands are accessible through CAINTEST: 


CLRPARM 
HELP 
LISTPARM 
QUIT 
RESPORD 
SEND 
SETAPPL 
SETFAM 
SETMSG 
SETQUERY 
SETRESP 
SETTRANS 
SHOWFLDS 
TIMEOUT 
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SETQUERY 
Purpose 
SETQUERY (Set Query) selects the query used with CAINTEST. 
Access 
>CAINTEST 
Syntax 
>SETQUERY query# 
Parameters 
Command parameters are described in Table 1-19. 
Table 1-19 


SETQUERY parameter description 


Parameter Values Description 


query# 1to3 Specifies the query number. 


Example command 
>SETQUERY 1 


Responses 


If no values are specified for this command, the command syntax displays. 
The following is an example response to the SETQUERY command with an 
incorrect application specified: 


>SETQUERY KJHKJ 
Next par is: <Query_number> {1 TO 3} 
Enter: <Query_number> 


Related commands 
The following commands are accessible through CAINTEST: 


e CLRPARM 
e HELP 

e LISTPARM 
e QUIT 

e RESPORD 

e SEND 
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SETQUERY (end) 


e SETAPPL 

e SETFAM 

e SETMSG 

e SETPARM 

e SETRESP 

e SETTRANS 
e SHOWFLDS 
e TIMEOUT 
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SETRESP 
Purpose 
SETRESP (Set Response) selects the response used with CAINTEST. 
Access 
>CAINTEST 
Syntax 
>SETRESP resp# 
Parameters 
Command parameters are described in Table 1-20. 
Table 1-20 
SETRESP parameter description 
Parameter Values Description 
resp# 1 to 3 Specifies the response number. 
—end— 


Example command 
>SETRESP 1 


Responses 
If no values are specified for this command, the command syntax displays. 
The following is an example response to the SETRESP command with an 
incorrect application specified: 


>SETRESP KJHKJ 
Next par is: <Response_number> {1 TO 3} 
Enter: <Response_number> 


Related commands 
The following commands are accessible through CAINTEST: 


e CLRPARM 
e HELP 
e LISTPARM 
e QUIT 
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SETRESP (end) 


e RESPORD 

e SEND 

e  SETAPPL 

e SETFAM 

e SETMSG 

e SETPARM 

e SETQUERY 
e SETTRANS 

e SHOWFLDS 
e TIMEOUT 
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SETTRANS 
Purpose 
SETTRANS (Set Transport) specifies the transport medium. 
Access 
>CAINTEST 
Syntax 
>SETTRANS msg_prtcl gt_name gt value 
Parameters 
Command parameters are described in Table 1-21.. 
Table 1-21 
SETTRANS parameter descriptions 
Parameter Values Description 
msg_prtcl TCAP_sccp Specifies the transport medium. 
gt_name CAIN _CLID_GT Specifies any global title name. 


CAIN _ADDR_GT 
CAIN_OFCD_GT 
CAIN_FEAT_GT 

E800BELLCORE 


gt_value Vector of 10 digits Specifies global title value. 


—end— 


Example command 
>SETTRANS TCAP_sccp CAIN_OFCD_GT 123 


Responses 
The following is an example response for the SETTRANS command. If no 
values are specified for this command, SETTRANS displays. 


>SETTRANS ALL 
QUERY 1 
APPLICATION :CAINO2 
TRANSPORT :tcap_sccp_ cain_ofcd_gt 123 
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SETTRANS (end) 


TIMEOUT 23 sec 

MESSAGE :info_analyzed 
UserID:DN 2132221234 
Cldno:Natl 2145323773 
ChgNo:Natl 2143562784 


Related commands 
The following commands are accessible through CAINTEST: 


e CLRPARM 
e HELP 

e LISTPARM 
e QUIT 

e RESPORD 

e SEND 

e  SETAPPL 

e SETFAM 

e SETMSG 

e SETPARM 

e SETQUERY 
e SETRESP 

e SHOWFLDS 
e TIMEOUT 
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SHOWFLDS 


Purpose 


Access 


Syntax 


Parameters 


Table 1-22 


The Show Fields (SHOWFLDS) command allows you to view the current 
parameter values that have been set for a particular Query or Response 
message. This command also allows you to view all the parameters that have 
been set at the same time. Also, included is the USERID privfac encoding 
type and the AMP1 parameter. 


>CAINTEST 


>SHOWFLDS <field_name> 
>SHOWFLDS QUERY query# 
>SHOWFLDS RESPONSE response# 
>SHOWFLDS ALL 


Note: This command shows the latest message that is being built. 


Command parameters are described in Table 1-22. 


SHOWFLDS parameter descriptions 


Parameter 


Values Description 


<field_name> 


<parm_name>, Specifies the parameters or commands or both. 
<comm_name>, ALL 


parameter UNCHANGED Specifies the parameter to be displayed. 
command APPL, TRANS, MSG, Specifies the command to be displayed. 
TIMEOUT 
UNCHANGED 
query# 1 to 3 Specifies all parameters associated with the query 
number. 
—continued— 
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SHOWFLDS (continued) 


Table 1-22 


SHOWFLDS parameter descriptions (continued) 


Parameter Values Description 

response# 1to3 Specifies all parameters associated with the 
response number. 

ALL Specifies all parameters set for all messages 


(queries and responses) at the same time. 


—end— 


Example commands 


Responses 


>SHOWEFLDS all 


The following are examples of responses to the SHOWFLDS ALL 
command: 


Show all parameters associated with the Termination_Attempt trigger. 


>SETTRANS sccp cain_clid_gt 123 
>SETMSG TERMINATION_ATTEMPT 
>SHOWFLDS ALL 


Application : cain02 

Transport > tcap_secp cain_clid_gt 214 
Message : termination_attempt 

Timeout i713 


Show all parameters associated with the O_/EC_Reorigination trigger. 


>SETTRANS sccp cain_clid_gt 123 
>SETMSG FAILURE_OUTCOME 
>SHOWFLDS Query 1 


Application : cain02 
Transport : Ucap_usecp cain_clid_gt 214 
Message : FAILURE_OUTCOME 


Show all parameters associated with the Info_Analyzed trigger detection 
point. 


>SHOWFLDS ALL 
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SHOWFEFLDS (end) 


QUERY 1 
Application : cain02 
Transport : tcap_sccp cain_addr_gt 214 
Timeout : 30 sec 
Family : DMS250 
Message : info_analyzed 
BearCap : speech 


Note: All parameters associated with this command are optional. 
Therefore, if a parameter is entered incorrectly, CAINTEST will not offer a 
description of the optional parameter values. Additionally, if SHOWFLDS 
is entered with no optional parameters, the most recently edited messages 
will be displayed. 


Related commands 
The following commands are accessible through CAINTEST: 


e CLRPARM 
e HELP 

e LISTPARM 
e QUIT 

e RESPORD 
e SEND 

e  SETAPPL 

e SETFAM 

e SETMSG 

e SETPARM 
e SETQUERY 
e SETRESP 

e SETTRANS 
e TIMEOUT 
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TIMEOUT 


Purpose 


The Timeout (TIMEOUT) command allows you to override the value of the 
T1 timer for a given test query. The T1 timer measures the response in 
seconds. If the response does not come back from the service control point 
within the specified time period, a time-out error will occur. 


Note: CAINTEST does not send a Report_Error to the SCP. 


Access 
>CAINTEST 
Syntax 
>TIMEOUT timevalue 
Parameters 
Command parameters are described in Table 1-23. 
Table 1-23 
TIMEOUT parameter description 
Parameter Values Description 
timevalue 1 to 60 Period of time (in seconds) the user waits for an 


answer before an error is received. 


—end— 


Example command 


Responses 


>TIMEOUT 9 


If no time-out value is set, the default value is set. The default value is 
located in CAIN_T1_TIMEOUT (table CAINPARM). 
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TIMEOUT (end) 


The following error messages may display as a result of the TIMEOUT 
command: 


Invalid timeout value 


Explanation: 
User tried to assign a time-out value that exceeds the range of the 
time-out parameter. 


System action: 
The system aborts the command and displays valid message entries. 


User action: 
Enter a valid time-out value. 


Related commands 
The following commands are accessible through CAINTEST: 


e CLRPARM 
e HELP 

e LISTPARM 
e QUIT 

e RESPORD 

e SEND 

e  SETAPPL 

e SETFAM 

e SETMSG 

e SETPARM 

e SETQUERY 
e SETRESP 

e SETTRANS 
e SHOWFLDS 
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CCS directory 


CCS (end) 
Purpose 
The Common Channel Signaling (CCS) command provides entry into the 
CCS directory in order to monitor and maintain the CCS subsystem. 
Note: Related commands listed in this section are accessed through the 
Signaling Connection Control Part Location (SCCPLOC) command. 
SCCPLOC is accessible once the CCS command has been entered. 
Access 
>MAPCI:MTC;CCS;SCCPLOC 
Syntax 
>COMMAND 
Parameters 
None 


Example command 
>CCS 


Responses 
None 


Related commands 


The following commands are accessed through the SCCPLOC directory 
after the CCS command has been entered: 


e TESTSS 

e TESTSS ACCTSS 
e TESTSS AUTHSS 
e TESTSS NOO 
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TESTSS 


Purpose 


The Test Subsystem (TESTSS) command activates CCS7-related application 
software to verify the integrity of a subsystem. 


Note: Before using TESTSS, use the POST command to post the subsystem 
to be tested. The subsystem must be local. 


Restrictions 
Restrictions associated with the use of TESTSS include: 


e Any queries to the SCP that are rejected are not attempted again. 
e Each of the application subsystems to be used must be in service. 
e Remote databases must be operational. 
e Datafill must be entered in the following tables: 

— C7GTT 

— C7GTTYPE 

— C7LKSET 

— C7LINK 

— C7LOCSSN 

— C7NETWRK 

— C7RTESET 


Access 
>CCS;SCCPLOC 


Syntax 


>TESTSS name of subsystem parameters depending on the subsystem 


Parameters 
Command parameters are described in Table 1-24. 
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CCS commands 
TESTSS (continued) 


Table 1-24 
TESTSS parameter descriptions 
Parameter Values Description 
name of Valid values include: Specifies the subsystem name. 
subsystem Radios 
Accttest 
Authss 
Authtest 
NOoOtest 
NOO 
Ten 
Tentest 
parameters variable Specifies parameters associated with the named 
subsystem. 
Note: Required values are dependent on the 
subsystem value. 
—end— 


Example command 


The following shows an example TESTSS command with the NOO 
subsystem specified. 


>TESTSS N00 2141234567 8001234545 


Responses 
The following error messages may display as a result of the TESTSS 
command: 


9999 


Note: The system supplies the values represented by ”x”. 


A reject message is received from the RDB. 


Explanation: 
The remote database rejected the query from the UCS DMS-250 
switch. 
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TESTSS (continued) 


An error message is received from the RDB. 
Explanation: 


The remote database could not generate a response due to a transient 


error. 


System action: 
The response message is rejected. 


An error is recognized in the TCAP decoding facilities. 


Explanation: 


The remote database response message violated TCAP syntax. 


System action: 
The response message is rejected. 


Authcode number is incorrect 
Number of digits has to be from 5 to 7 


Explanation: 


For query type AUTHACCT, an incorrect number of digits was 


entered. 


System action: 
No query was sent to the SCP. 


User action: 
Enter the command again with a 5- to 7-digit authcode. 


Bad parameter in the message. 
Explanation: 
A bad parameter exists in the TCAP message. 


System action: 
Correct the parameter and proceed. 


Encoder failed to assemble the query. 


Explanation: 
The query is aborted. This is an unexpected situation. 


User action: 
Try the query again. 
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TESTSS (continued) 


Failed to wait in order to receive a message. Mailbox failure 
code is = xx. 


Explanation: 
The system failed to wait for the response message. This is an 
unexpected situation. 


User action: 
Save the software error report for resolution of the problem. 


No response within assigned time out value. Timeout value is: 
x seconds 


Explanation: 
The timeout value assigned in the command has expired. 


System action: 
The system aborted the query. 


Number of parameters in the response message is incorrect. 


Explanation: 
The switch received a response message from the RDB, but it did not 
have the correct number of TCAP parameters. 


System action: 
The response message is rejected. 


Private parameter of the response msg had wrong length. 


Query 


Explanation: 
The switch received a response message from the RDB, but the 
length of the response is incorrect. 


System action: 
The response message is rejected. 


could not be sent to the RDB. 


Explanation: 
The query is aborted. 


User action: 
Try the query again and save the software error report for resolution 
of the problem. 
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TESTSS (continued) 


The component is not a national TCAP type. 


Explanation: 
The component of the received message is not coded as a national 
type. 


System action: 
The message is rejected. 


This query could not be sent to the RDB. It is bounced back 
to us by lower level of CCS7. 


Explanation: 
The system constructed the query, but it was returned to the switch 
instead of being sent to the remote database. 


User action: 
Verify the MTP linksets and routesets are inservice. 


This parameter is not a private TCAP type. 


Explanation: 
The parameter group of the received message is not coded as a 
private TCAP parameter. A private parameter is expected. 


User action: 
Enter a valid private parameter. 


The TCAP decoder failed to decode the response message. 
Packaging information is incorrect. 


Explanation: 
The TCAP coder failed to decode the received message. 


System action: 
The message is rejected. 


Too many users are logged onto this TESTSS. 


Explanation: 
More people are using the TESTSS command than defined in the 
office parameters. 


User action: 
Verify office parameter TESTSS250 MAX USERS is sufficient. 
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TESTSS (end) 


Related commands 
Use the POST command to post the subsystem to be tested. The subsystem 
must be local. 
The following CCS;SCCPLOC commands are related to this command: 
e TESTSS ACCTSS 
e TESTSS AUTHSS 
e TESTS N00 
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TESTSS ACCTSS 


Purpose 
The Test Subsystem Account Code Validation Subsystem (TESTSS 
ACCTSS) command performs one of the following: 


e validates the following account code types: 
— authcode (AUTHACCT) 
— authcode and a speed number (AUTHSNAC) 
— automatic number identification (ANI) 
— travel card number (TCN) 


e translates an authcode-associated private speed number (AUTHSPEE) to 
the destination number stored in the service control point (SCP) 


Restrictions 
Restrictions associated with the use of TESTSS include: 


e ACCTSS subsystem must be in service 


e ACCTSS subsystem has been posted using the POST command 


Access 
>CCS;CCS7;SCCPLOC 


Syntax 


The TESTSS ACCTSS command has the following parameters for each 
query type: AUTHACCT, AUTHSPEE, AUTHSNAC, ANI, and TCN. 


>TESTSS ACCTSS AUTHACCT adin authcode auth _acct timeout 
>TESTSS ACCTSS AUTHSPEE adin authcode speed_no timeout 
>TESTSS ACCTSS AUTHSNAC adin authcode speed_no authacct timeout 
>TESTSS ACCTSS ANI ani_no ani_acct timeout 

>TESTSS ACCTSS TCN icn_no icn_acct timeout 


Parameters 
Command parameters are described in Table 1-25. 
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TESTSS ACCTSS (continued) 


Table 1-25 

TESTSS ACCTSS parameter descriptions 
Parameter Values Description 
adin 0 to 99 Specifies the authcode database index number. 
authcode 5 to 7 digits Specifies the authorization code (associated with 


the account code to be validated or the speed 
number to be translated). 


authacct 1 to 12 digits Specifies the account code to be validated 
(associated with an authcode). 

speed_no 100 to 199 Private speed number to be translated. 

ani_no 10 digits required Specifies the automatic number identification (ANI) 
number. 

ani_acct String Specifies the account code to be validated 
(associated with an ANI). 

tcn_no String Specifies the travel card number (TCN). 

tcn_acct String Specifies the account code to be validated 
(associated with a TCN). 

timeout 1 to 30 Specifies the wait time (in seconds) for reply back 

(optional from the SCP. 

parameter) 

—end— 


Example command 
>TESTSS ACCTSS AUTHACCT 0 54321 123456789012 


Responses 


If all parameters are valid, the query is sent to the SCP for validation and the 
results are displayed on the MAP terminal: 


>TESTSS ACCTSS AUTHACCT 0 54321 123456789012 
THE DCP RESPONSE TOOK 0 SECONDS AND 8 MILLISECONDS FOR 
AUTHCODE 00 54321 ACCOUNT CODE 123456789012 IS VALID. 


297-2621-819 Standard 14.01 April 2002 


Commands 1-105 


CCS commands 
TESTSS ACCTSS (continued) 


Error messages 


The following error messages may display as a result of the TESTSS 
ACCTS command: 


Authcode number is incorrect 
Number of digits has to be 5 to 7 


Explanation: 
For query type AUTHACCT, an incorrect number of digits was 
entered. 


System action: 
No query was sent to the SCP. The command is ended. 


Account code number out of range, >12 


Explanation: 
For query types AUTHACCT or ANI, a number of ACCTCODE 
digits greater than 12 was entered. 


System action: 
The command is ended. 


User action: 
Try the command again and verify the problem with the SCP. 


<Error message> SOC Option CRDSO002 ”CRDS TCAP Card 
Services.” 


Explanation: 
The user tried to display the travel card number with this command 
while software optionality control (SOC) option CRDS0002 is IDLE. 


User action: 
Ensure SOC option CRDS0002 is set to IDLE and verify this option 
was not purchased from Northern Telecom. 


Note: For additional information on SOC, refer to the SOC 
commands in this manual or see the DMS-100 Software Optionality 
Control User’s Manual. 
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TESTSS ACCTSS (end) 


Related commands 


The ACCTTEST and TESTSS ACCTSS commands function in the same 


manner. The only difference in the two commands is how they are invoked 
at the MAP level. 
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TESTSS AUTHSS 
Purpose 
The Test Subsystem Authorization Code Validation Subsystem (TESTSS 
AUTHSS) command tests whether an authcode number exists in the service 
control point (SCP). 
Note: If the requested authcode exists, the related authocode data stored in 
the SCP displays. 
Access 
>CCS;CCS7;SCCPLOC 
Syntax 
>TESTSS AUTHSS authcode adin timeout 
Parameters 
Command parameter fields are described in Table 1-26. 
Table 1-26 
TESTSS AUTHSS parameter descriptions 
Parameter Values Description 
authcode 5 to 7 digits Specifies the authorization code (associated with 


the account code) to be validated or the speed 
number to be translated. 


adin 0 to 99 Specifies the authcode database index number. 
timeout 1 to 30 Specifies the wait time (in seconds) for a reply 
(optional back from the SCP. 
parameter) 

—end— 
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TESTSS AUTHSS (continued) 


Responses 


The following is an example of a response to the TESTSS AUTHSS 
command: 


>TESTSS AUTHSS 5123456 4 3 


TIME FOR SENDING QUERY AND RECEIVING RESPONSE IS: 
xx MINUTES, xx SECONDS, xxxx MILLISECONDS. 

THE FOLLOWING DATA WERE RETURNED FROM THE SCP: 

THE AUTHCODE NUMBER 5123456 IS VALID 

ACCOUNT CODE VALIDATION N 

ACCOUUNT CODE LENGTH 0 

ORIGINATING PARTITION 111 

TERMINATING PARTITION 30 

PRIVATE SPEED ALLOWED N 

PIN LENGTH 2 

MULTIPLE PIN N 

HOTLINE NUMBER 

SATELLITE RESTRICTION 


AUTHCODE ABUSE TRAP 


N 
FILED AUTHCODE ONLY N 
Y 
SPLASHBACK CLASS 2 


TRAVEL ALLOWED N 
CLASS OF SERVICE 1022 
PIN LIST: 22 


Error messages 


The following error messages may display as a result of the TESTSS 
AUTHSS command: 


Account code number out of range, >12 


Explanation: 
There is an error in the authcode data received from the SCP. More 
than 12 account code digits were entered. 


System action: 
The command is ended. 


User action: 
Try the command again and verify the problem with the SCP. 
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TESTSS AUTHSS (end) 


Related commands 


The AUTHTEST and TESTSS ACCTSS commands function in the same 
manner. The only difference in the two commands is how they are invoked 
at the MAP level. 
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TESTSS NOO 


Purpose 


Restrictions 


The Test Subsystem NOO (TESTSS N00) command tests the NOO transaction 
capability application part (TCAP) application subsystem. This is done by 
manually initiating NOO TCAP queries for a specified calling and NXX 
number (where N=2-—0; X=0-9). 


TESTSS NO0 sends a 10-digit automatic number identification (ANI) or 
pseudo automatic number identification (PANI) value in a NOO TCAP 
invoke message. The value is used to translate a NOO number through a 
service control point (SCP). The following trunk types are supported: 


e ANI—Feature Group D (FGD) Equal Access Network Trunk (EANT) 
e PANI—NO0 remotely translated direct access line (DAL), offnet access 
line (ONAL), and offnet access trunk (ONAT) 


TESTSS also displays the automatic code gapping (ACG) response sent 
back from the service control point (SCP). This command can also be used 
to remove ACG controls (except for STOP_ALL_CALLS). 


Restrictions associated with TESTSS NOO0 include: 

e Prerequisites 
— NOOTEST and NOO subsystems are in service. 
— SCP is operational. 
— All other system responses have not changed. 
— System has been posted to test using the POST. 


Note: The subsystem must be “local” when testing. 


e PANI call processing 


— System does not screen personal identification number (PIN) for 
PANI calls. 


— All PANIs are validated in the ANI database. 
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TESTSS NOO (continued) 


¢ Trunking requirements 


— Calls that originate on a DAL, ONAL, ONAT trunk are handled as 
PANI calls. 


— NOO origination on DAL trunks is limited to 700 and 800 prefixed 
calls. 
e Message format 
— If the switch expects one type of message format from the SCP, and 
receives a different type, the message is considered erroneous. 
e Table requirements 
— C7GTT 
— C7GTTYPE 
— C7LKSET 
— C7LINK 
— C7LOCSSN 
— C7NETWRK 
— C7RTESET 


e Office parameters 


— ENHANCED_NO0_TCAP in table Office Variable (OFCVAR) must 
be datafilled to indicate one of the following ANI formats: 


- 3-digit ANI 
— 6-digit ANI 
— 10-digit ANI 


Access 
>CCS;CCS7;SCCPLOC 


Syntax 
>TESTSS N00 ‘ani n0O_ number’ timeout 
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TESTSS NOO (continued) 


Parameters 
Command parameters are described in Table 1-27. 
Table 1-27 
TESTSS NOO parameter descriptions 
Parameter Values Description 
ani NPA-NXX-XXXX Specifies the ANI number (8-, 6-, or 10-digit). Value 
must be surrounded by single quotes. 
n00_number NXXNXXXXXX Specifies the NOO number (10-digit). 
timeout 1 to 30 Specifies the wait time (in seconds) for a reply 
(optional back from the SCP. 
parameter) 


Note: lf a value is not specified, the system uses 
the default value defined in the 
NOO_DCP_RESPONSE _ 

TIMEOUT (table OFCVAR). 


—end— 


Example command 
>TESTSS N00 ‘214907’ 9009901234 5 

Responses 
After the TESTSS NOO command successfully completes, the system 
displays one of the following responses: 


Note: The system supplies the values represented by ”x”. 


Default ANI is used in place of the actual data. 


Explanation: 


The system recognized an error in the data and used the default ANI 
in place of the ANI entered. 


User action: 
None 
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TESTSS NOO (continued) 


Query number does not exist in the DCP database. 
Explanation: 
The ANI does not exist in the remote database. 


User action: 
Verify ANI (if required). 


The ANI number xxxxxxxxxx is valid 
COS Index: 0 


Explanation: 
The system displays the ANI’s index number and indicates if ANI is 
valid. 


User action: 
None 


The following data was returned from the SCP: The NOO number 


translates to: XXXXXXXXX 
Called party billing: XXX 

CPI provided: XX 

Satellite restriction: XX 

Nature of number: XX 

Originating partition: XXX 

Terminating partition: XXX 

Bearer capability code: XXXXXXXXXXX 


Translation billing type: xx 


Explanation: 
The ANI entered is less than 12 digits and the ANI must be at least 
12 digits long. Any number of digits less than 12 digits is an error. 


User action: 
Re-enter valid ANI. 


Warning::: Number of digits is xx 
The acceptable lengths are 12-23 digits, but the query is 
sent to the DCP anyway. 


Explanation: 
The system displays the information received from the query. 


User action: 
None 


Digital Switching Systems UCS DMS-250 Commands Reference Manual UCS17 


1-114 Commands 


CCS commands 


TESTSS NOO (continued) 


TIME FOR SENDING QUERY AND RECEIVING RESPONSE IS: X MINUTES, 
Y SECONDS, Z MILLISECONDS 
THE CALL WOULD BE ROUTED TO THE TREATMENT INDICATED IN THE 


OFFIC! 


= 
ay 


PARAMETER NOO_ACG_TRMT IN TABLE OFCVAR. 


CURRENTLY NOO_ACG_TRMT IS NOO_CALL_ BLOCKED. 

THE FOLLOWING DATA WERE RETURNED FROM THE SCP IN THE 
AUTOMATIC CODE GAPPING (ACG) COMPONENT: 

CONTROL CODE: <control code> 

CONTROL CAUSE INDICATOR: <control cause indicator> 
GAP INDEX: XXXSEC 

DURATION SECONDS: XXXSEC 


Explanation: 

A response to an NOO TCAP invoke with the ACG component 
returned. The NOO number does not have ACG applied. The ACG 
component is returned from the SCP. 


User action: 
Verify input. 


THIS N00 NUMBER CURRENTLY HAS ACG CONTROLS APPLIED. THE CALL 


WOULD BE ROUTED TO THE TREATMENT INDICATED BY THE OFFICE 
PARAMETER NOO_ACG_TRMT IN TABLE OFCVAR. 

CURRENTLY NOO_ACG_TRMT IS NOO_CALL_BLOCKED. 
THE FOLLOWING DAT AIS CURRENTLY IN THE CONTROL LIST WITH 


AUTOMATIC CODE GAPPING (ACG) INVOKED: 

CONTROL CODE: <control code> 

CONTROL CAUSE INDICATOR: <control cause indicator> 
GAP VALUE: XXXX 

DURATION VALUE: XXX 


Explanation: 
The NOO number currently has ACG applied. 


User action: 
None 


Error messages 


The following error messages may display as a result of the TESTSS N00 
command. 


66,99 


Note: The system supplies the values represented by “x”. 
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TESTSS NOO (continued) 


A reject message is received from the SCP. 
Explanation: 
The service control point rejected the query from the switch. 


System action: 
The response message is rejected. 


An error is recognized in the TCAP decoding facilities. 
Explanation: 
The service control point response message violated TCAP syntax. 


System action: 
The response message is rejected. 


An error message is received from the DCP. 


Explanation: 
The service control point could not generate a response due to a 
transient error. 


System action: 
The response message is rejected. 


Bad parameter in the message. 
Explanation: 
A bad parameter exists in the TCAP message. 


System action: 
The response message is rejected. 


Either the ANI is invalid or it does not exist in the DCP. 
Explanation: 
The remote database did not recognize the ANI in the query. 


User action: 
Verify the ANI is valid. 
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TESTSS NOO (continued) 


Encoder failed to assemble the query. 
Explanation: 
The query is aborted. This is an unexpected situation. 


User action: 
Try the query again. 


Failed to wait in order to receive a message. Mailbox 


failure code is = xx. 


Explanation: 
The system failed to wait for the response message. This is an 
unexpected situation. 


User action: 
Save the software error report for resolution of the problem. 


Invalid digits in ANI parameter. 


Explanation: 
The acceptable digits are numeric digits only (0—9). Any other 
characters are rejected. 


User action: 
Enter a correct automatic number identification. 


No response within office assigned timeout value 
Timeout value is: x seconds 


Explanation: 
The timeout value assigned in the command has expired. 


System action: 
The system aborted the query. 


NOO number is not 10 digits. 


Explanation: 
The NOO number entered did not contain ten digits. 


User action: 
Correct the NOO entered. 
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TESTSS NOO (continued) 


Number of parameters in the response message is incorrect. 


Explanation: 
The switch received a response message from the SCP, but it did not 
have the correct number of TCAP parameters. 


System action: 
The response message is rejected. 


Private parameter of the response msg had wrong length. 


Explanation: 
The switch received a response message from the SCP, but the length 
of the response is incorrect. 


System action: 
The response message is rejected. 


Query could not be sent to the DCP. 


Explanation: 
The query is aborted. 


User action: 
Try the query again and save the software error report for resolution 
of the problem. 


The ANI contains more than 10 digits. 


Explanation: 
The ANI contains more than 10 digits. Any digit length more than 10 
is considered an error. 


User action: 
Enter a correct ANI. 


The component is not a national TCAP type. 


Explanation: 
The component of the received message is not coded as a national 
type. 


System action: 
The message is rejected. 
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TESTSS NOO (continued) 


The component is not recognized. 


Explanation: 

Three types of response messages undergo ANI validation. These 
types are RETURN RESULT, REJECT, and ERROR. Any other type 
of response is invalid. 


System action: 
The message is rejected. 


The parameter is not a private TCAP type. 


Explanation: 
The parameter group of the received message is not coded as a 
private TCAP parameter. A private parameter is expected. 


System action: 
The message is rejected. 


The TCAP decoder failed to decode the response message. 
Packaging information is incorrect. 


Explanation: 
The TCAP coder failed to decode the received message. 


System action: 
The message is rejected. 


The query could not be sent to the DCP. It is bounced back by 
lower level of CCS7. 


Explanation: 
The system constructed the query, but it was returned to the switch 
instead of being sent to the remote database. 


User action: 
Verify the MTP linksets and routesets are in service. 


Too many users are logged onto this TESTSS. 


Explanation: 
More people are using the TESTSS command than defined in the 
office parameters. 


User action: 
Verify office parameter TESTSS250_MAX_USERS is sufficient. 
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TESTSS NOO (end) 


Related commands 
Use the TESTSS command to verify the integrity of a subsystem. 


Use the POST command to post the subsystem to be tested. The subsystem 
must be local. 
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Cl 


Purpose 


The Command Interpreter (CI) command provides entry into the 
Maintenance and Administration Position (MAP) terminal and its 
commands. The CI command level is accessed automatically when a user 
logs on the MAP. 


The command interpreter is a support-operating system component that 
functions as the main interface between the MAP terminal and user. It 
performs the following: 


e reads lines entered by the terminal user 

e breaks each line into recognizable units 

e analyzes the units 

e recognizes command item-numbers on input lines 
e invokes commands 


Access 
CI commands are accessible from any MAP level. 


Syntax 
>Cl: 


Parameters 
None 


Responses 
None 


Related commands 
The following CI commands are located in this section: 


ACCTTEST 
AUTHTESST 

CLLIREF MEMBERLESS 
CLLIREF SEARCH 
ECMON 
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Cl (end) 


LISTAB 

NOOTEST 

QACCT 

TCNTEST 

TRAVER 

VPTRACE 

Note: This list does not contain all available CI commands. Commands in 


this section are specific to the basic operation and maintenance of the UCS 
DMS-250 switch. 
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ACCTTEST 


Purpose 
The ACCTTEST (ACCTcode Test) command performs the following: 


e validates the following account code types: 
— authcode (AUTHACCT) 
— authcode and a speed number (AUTHSNAC) 
— automatic number identification (ANI) 
— travel card number (TCN) 


e translates an authcode-associated private speed number (AUTHSPEE) to 
the destination number stored in the service control point (SCP) 


Restrictions 
The ACCTSS subsystem must be in service before entering the ACCTTEST 
command. 


Access 
Accessible from any MAP level. 


Syntax 
>ACCTTEST AUTHACCT adin authcode auth_acct timeout 
>ACCTTEST AUTHSPEE adin authcode speed_no timeout 
>ACCTTEST AUTHSNAC adin authcode speed_no authacct timeout 
>ACCTTEST ANI ani_no ani_acct timeout 
>ACCTTEST TCN tcn_no tcn_acct timeout 
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ACCTTEST (continued) 


Parameters 


Command parameters are described in Table 1-28. 


Table 1-28 
ACCTTEST parameter descriptions 
Parameter Values Description 
adin 0 to 99 Specifies the authcode database index number. 
authcode 5 to 7 digits Specifies the authorization code associated with the 
account code to be validated or the speed number to 
be translated. 
auth_acct 1 to 12 digits Specifies the account code associated with the 
authorization code to be validated. 
speed_no 100 to 199 Specifies the private speed number to be translated. 
ani_no 10 digit string Specifies the automatic number identification (ANI). 
ani_acct 1 to 12 digits Specifies the account code associated with an 
automatic number identification to be validated. 
tcn_no 14 digits Specifies the travel card number (TCN). 
tcn_acct 14 digits Specifies the account code associated with a TCN to 
be validated. 
timeout 1 to 30 Specifies the wait time (in seconds) for a reply back 
(optional from the SCP. 
parameter) 


—end— 


Example command 
>ACCTTEST AUTHACCT 0 54321 123456789012 


Responses 


If all parameters are valid, the query is sent to the SCP for validation and the 
results are displayed on the MAP terminal. The following shows the system 

responses, including the example response for the command entry. A second 
command entry and its response is also shown: 


>ACCTTEST AUTHACCT 0 54321 123456789012 
THE DCP RESPONSE TOOK 0 SECONDS AND 8 MILLISECONDS FOR 


AUTHCODE 00 54321 
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ACCTTEST (continued) 


ACCOUNT CODE 123456789012 IS VALID. 
>ACCTTEST ANI 2083041234 3124861226 


THE 


NUMB] 


ACCO 


DCP RESPONSE TOOK 0 SECONDS AND 9 MILLISECONDS FOR ANI 
ER 208-304-1234 
UNT CODE 314861226 IS VALID. 


Error messages 


The following error messages may display as a result of the ACCTTEST 
command: 


Account code number out of range,>12 


Explanation: 
For query types AUTHACCT or ANI, a number of ACCTCODE 
digits greater than 12 was entered. The command is ended. 


User action: 
Try the command again and verify the problem with the SCP. 


Authcode number is incorrect 
Number of digits has to be from 5 to 7 


Explanation: 
For query type AUTHACCT, an incorrect number of digits was 
entered. No query was sent to the SCP. 


User action: 
Enter the command again with an authcode of 5 to 7 digits. 


<Error message> SOC Option CRDSO002 “CRDS TCAP Card 


Services.” 


Explanation: 

The user tried to display the travel card number with this command 
while the software optionality control (SOC) option CRDS0002 is 
IDLE. 


User action: 
Ensure the state of SOC option CRDS0002 is IDLE and verify this 
option was not purchased from Northern Telecom. 


Note: For additional information on SOC, refer to the SOC 
commands in this manual or see the DMS-100 Software Optionality 
Control User’s Manual. 
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ACCTTEST (end) 


Related commands 


The ACCTTEST and TESTSS ACCTSS commands function in the same 
manner. The only difference in the two commands is how they are invoked 
at the MAP level. 
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ACTSTAT 
Purpose 
The Automatic CDR Throttling Status (ACTSTAT) command provides 
information for the automatic CDR throttling system. 
The ACTSTAT command displays the following information: 
e the current throttling status, active, inactive, or disabled. 
e the high recording unit (RU) threshold, the current RU percentage, and 
the low RU threshold. 
e the high CPLOAD threshold, the current CPLOAD percentage, and the 
low CPLOAD threshold. 
e the current value of the office parameter CDR_FOR_ISUP. 
Access 
Accessible from the MAP level. 
Syntax 
>ACTSTAT 
Parameters 
Command parameters are described in Table 1-. 
Table 1-29 


ACTSTAT parameter descriptions 


Parameter Values Description 


Valid values include: 


—end— 


Example command 
>ACTSTAT 


Responses 
The following is an example response to the ACTSTAT command: 


>ACTSTAT 


297-2621-819 Standard 14.01 April 2002 


Commands 1-127 


Cl commands 
ACTSTAT (end) 


Auto CDR Throttling Status: DISABLED SOC UBFRO005 Idle 


RU RU RU CPLOAD CPLOAD CPLOAD CDR_ 
HI CUR- LO HI CUR- LO FOR_ 
RENT RENT ISUP 
90% 75% 70% 9 7 8 Y 
Explanation: 


Automatic CDR Throttling status could be ACTIVE, INACTIVE, or 
DISABLED SOC UBFROOOS IDLE. The last line displays the 
percentage of high recording unit (RU) usage threshold, current RU 
usage threshold, and low RU usage threshold. It also displays the 
value of the high CPLOAD threshold, the current CPLOAD index, 
the low CPLOAD threshold, and the value of CDR_ FOR_ISUP. 


Related commands 
None 
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ANIMOVE 


Purpose 


The Automatic Number Identification Move (ANIMOVE) command copies 
and converts the tuples from table ANISCUSP to table ANI Validation 
(ANIVAL) and table UNIversal PROFile (UNIPROF). The ANIMOVE 
command can perform a total or partial conversion, and is accessible from 


any MAP level. 


The ANIMOVE command provides the functions shown in Table 1-30. 


Table 1-30 
Help function parameter descriptions 

Function Description 

Help Displays a description of one of the 
ANIMOVE command’s functions and 
its parameters. 

Total Converts the entire ANISCUSP table 
at once. 

Partial Converts portions of the ANISCUSP 
database at atime. 

Status Displays a summary of the 
conversion. It includes the 
conversion type, the number of 
converted tuples in ANISCUSP, the 
number of entries in ANIVAL and the 
number of entries in UNIPROF. 

Purge Removes a range of already 
converted ANIs from ANISCUSP. 

Halt The Halt function stops either a 
Partial or Total ANIMOVE conversion 
that is in progress. 


Restrictions 


Restrictions associated with the ANIMOVE command include the 


following: 


e The Total, Partial, and Purge functions are only accessible to a single 


user at a time. 
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ANIMOVE (continued) 


Access 


Syntax 


Parameters 


e The Status and Halt functions can be issued as the conversion is in 
progress. 


e While the ANIMOVE command is running, additions and changes to 
tables ANISCUSP, ANIVAL and UNIPROF cannot occur. However, the 
tuples in these tables can still be read and displayed. 


>ANIMOVE 


The syntax for the ANIMOVE command is as follows: 


Next par is: <Function> {Help <Topic> {Total, 
Partial, 
Purge, 
Status, 
Halt}, 
Total, 
Partial <From Index> STRING 
<To Index> STRING, 
Purge <From Index> STRING 
<To Index> STRING, 
Status, 
Halt} 


The parameters of the ANIMOVE command’s various functions are 
described in Table 1-31 through Table 1-36: 


Table 1-31 
Help function parameter descriptions 
Parameter Values Description 
Topic Total, Partial, Identifies the ANIMOVE function for which 
Purge, Status, the command displays instructional 
Halt information. 
—end— 
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ANIMOVE (continued) 


Table 1-32 
Total function parameter descriptions 
Parameter Values Description 
None N/A N/A 
—end— 
Table 1-33 
Partial function parameter descriptions 
Parameter Values Description 
From Entry VECTOR OF The ANISCUSP conversion starting entry. 
UP TO 18 
(N,1,2,3,4,5,6, 
7,8,9,0,B,C,D, 
E,F) 
To Entry VECTOR OF The ANISCUSP conversion ending entry. 
UP TO 18 
(N,1,2,3,4,5,6, 
7,8,9,0,B,C,D, 
E,F) 
—end— 
Table 1-34 
Purge function parameter descriptions 
Parameter Values Description 
From Entry VECTOR OF The ANISCUSP removal starting entry. 
UP TO 18 
(N,1,2,3,4,5,6, 
7,8,9,0,B,C,D, 
E,F) 
—end— 
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ANIMOVE (continued) 


Table 1-35 
Status function parameter descriptions 
Parameter Values Description 
None N/A N/A 
—end— 
Table 1-36 
Halt function parameter descriptions 
Parameter Values Description 
None N/A N/A 
—end— 


Example Commands/Responses 
The following are example commands and responses for the ANIMOVE 
command’s various functions. The datafill values used in the ANIMOVE 
examples are for illustration purposes only. 


Z 
H 
< 
Q 
< 
(za 


Help Total 
Help Partial 


aa 
H H 
= g 
O QO 
< < 
wE m 


Help Purge 

Help Status 

Total 

Partial 214 2151234567 
Purge 214 215 

Status 

Halt 


zZ 
H 
< 
Q 
< 
(za 


Z Z 
H H 
= g 
OO 
< < 
w w 


D D Pp Ppp Pp pp 
Z Z 
H H 
z z 
O Q 
< < 
[za] Fl 


Z 
H 
< 
Q 
< 
(za 


Example when using the Help function 


The Help command displays a description of any ANIMOVE command’s 
functions. Specify any of the following on the command line: Total, Partial, 
Purge, Status, or Halt. 


>ANIMOVE Help <Topic> 


Digital Switching Systems UCS DMS-250 Commands Reference Manual UCS17 


1-132 Commands 


Cl commands 
ANIMOVE (continued) 


Responses for the Help function 


A query for help information on the Total function, aNIMovE Help Total, 
obtains the following response: 


Function: Total 


The Total function converts the entire ANISCUSP table to the ANIVAL 
and UNIPROF tables. The Total function prompts the user to confirm 
the total conversion of the ANISCUSP database. It is recommended not 
to run this function during high traffic times. 


A query for help information on the Partial function, ANIMOVE Help Partial, 
obtains the following response: 


Function: Partial 


The Partial function converts the range of tuples specified on the 
command line from table ANISCUSP to tables ANIVAL and UNIPROF. The 
Partial function displays the conversions starting and ending range, 
then prompts the user for confirmation to proceed. The starting and 


ending range values selected must be valid entries in table 
ANISCUSP. 


A query for help information on the Purge function, ANIMOVE Help Purge, 
obtains the following response: 


Function: Purge 


The Purge function removes a range of converted ANIs from table 
ANISCUSP. This command is used only after the verification and 
transition stage of the conversion is over. The Purge function 
displays the starting and ending range values, then prompts the 
user for confirmation to proceed. 


A query for help information on the Status function, ANIMOVE Help Status, 
obtains the following response: 


Function: Status 


The Status function displays a summary of the current conversion as 
it progresses or the result from the last conversion. This function 


displays the conversion type, the number of ANISCUSP tuples 
converted, the resulting number of tuples in tables ANIVAL and 
UNIPROF, and the last ANISCUSP tuple converted. 
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ANIMOVE (continued) 


A query for help information on the Halt function, anImMovE Help halt, 
obtains the following response: 


Function: Halt 


The Halt function stops either a Partial or Total ANIMOVE conversion 
that is in progress. After the conversion is stopped, the ANIMOVE 


command exits, and the conversion type, the number of ANISCUSP 
tuples converted, the resulting number of tuples in tables ANIVAL 
and UNIPROF, and the last ANISCUSP tuple converted is displayed. 


System 
The Help function does not require system action. 


User action: 
The Help function does not require user action other than entering 
correct syntax at the command line. 


Example when using the Total function 


The Total comand converts the entire ANISCUSP table at once. This 
command keeps track of whether the total conversion has already been 
executed. 


This section provides possible responses for two example uses of the 
ANIMOVE command’s Total function. The response includes a warning, a 
confirmation clause, and a completion statement. 


>ANIMOVE Total 


Responses for the Total function 


An example of a successful Total function, ANIMovE Total, obtains the 
following response: 


You are CONVERTING the entire ANISCUSP database to the 
ANIVAL/UNIPROF database. This function impacts the switch’s capacity 
and performance. It is recommended not to run this function during 
high traffic times. 


Please confirm (“YES”, “Y”, “NO”, or “N”): 

>y 

>> Elapsed time: 00:00:01 Tuples Converted: 100 
>> Elapsed time: 00:00:02 Tuples Converted: 200 
>> Elapsed time: 00:00:04 Tuples Converted: 300 
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ANIMOVE (continued) 


Total conversion complete. 


An example of the Total function (when the function has been executed at 
least once before), ANIMovVE Total, obtains the following response: 


This function has been executed at least once before. Only the 
ANISCSUP tuples not yet converted are transferred. However, if the 
entire conversion needs to be executed again, you need to delete all 
the entries from ANIVAL and UNIPROF before proceeding. This function 
impacts the switch’s capacity and performance. It is recommended not 
to run this function during high traffic times. 


Please confirm (“Yes”, “Y”, “No”, or “N”): 
>y 
Total conversion complete. 


System action: 
A successful Total function increases the tuples in tables ANIVAL 
and UNIPROF. 


User action: 
The user must confirm the total conversion of the database. 


Example when using the Partial function 


The Partial command converts portions of the ANISCUSP database at a 
time. 


This section provides possible responses for all example uses of the 
ANIMOVE command’s Partial function. The response includes the range of 
ANIs to convert, a warning, a confirmation clause, and a completion 
statement. 


>ANIMOVE Partial <From Entry> <To Entry> 


Responses for the Partial function 


An example of a successful Partial function, aNIMovE Partial 214 
2146112211, obtains the following response: 


You are CONVERTING a portion of the ANISCUSP database: 
From Database Entry: 214 
To Database Entry: 2146112211 
This function impacts the switch’s capacity and performance. 


Please confirm (“YES”, YY”; “NO”, or “N”): 
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ANIMOVE (continued) 


>y 
Partial conversion complete. 


An example of a Partial function with a source entry with no datafill, 
ANIMOVE Partial 2146110000 2146112211, Obtains the following response: 


The <from> ANI does not exist in table ANISCUSP. 
You must enter a valid ANI that exists in table ANISCUSP. 


An example of a Partial function with a target entry with no datafill, anrmove 
Partial 2146110000 2146112211, obtains the following response: 


DJ 


The <to> ANI does not exist in table ANISCUSP. 
You must enter a valid ANI that exists in table ANISCUSP. 


An example of a Partial function with a source entry that contains invalid 
characters, ANIMOVE Partial abc 2146112211, Obtains the following 
response: 


The <from> ANI contains invalid characters. 
Use {1,2,3,4,5,6,7,8,9,0} 


An example of a Partial function with a target entry that contains invalid 
characters, ANIMOVE Partial 2146112211 abc, obtains the following 
response: 


The <to> ANI contains invalid characters. 
Use {1,2,3,4,5,6,7,8,9,0} 


An example of a Partial function with a source entry that is an invalid ANI 
length, ANIMOVE Partial 2145 2146112211, obtains the following response: 


The <from> ANI must be 3-, 6-, or 10-digits. 
The ANI you entered is 4 digits. 


An example of a Partial function with a target entry that is an invalid ANI 
length, ANIMOVE Partial 2146112211 12345678912, obtains the following 
response: 


The <to> ANI must be 3-, 6-, or 10-digits. 
The ANI you entered is more than 10 digits. 


An example of a Partial function with a source entry that is greater than a 
target entry, ANIMOVE Partial 215 214, obtains the following response: 


You entered an invalid range. The location of the <from> ANI 
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ANIMOVE (continued) 


must come before the <to> ANI in table ANISCUSP. 
For example: 
ANIMOVE Partial 214 215 


System action: 
A successful Partial function increases the tuples in tables ANIVAL 
and UNIPROF. 


User action: 
The user must confirm the partial conversion of the database. 


Example when using the Purge function 


The Purge command removes portions of the ANISCUSP database that have 
successfully been converted. Only the ANIs which have been converted 
through ANIMOVE Total or Partial commands are purged. 


This section provides possible responses for example uses of the ANIMOVE 
command’s Purge function. The response includes the range of ANIs to 
convert, a warning, a confirmation clause, and a completion statement. 


>ANIMOVE Purge <From Entry> <To Entry> 


Responses for the Purge function 


An example of a successful Purge function, ANIMOVE Purge 214 2146112211, 
obtains the following response: 


You are REMOVING a portion of the ANISCUSP database that has been 
converted through ANIMOVE Total or Partial functions: 


From Database Entry: 214 

To Database Entry: 2146112211 
Please confirm (“Yes”, “Y”, “No”, or “N”): 
>y 
Purge complete. 


An example of a Purge function with a source entry with no datafill, antmove 
Purge 2146110000 2146112211, Obtains the following response: 


The <from> ANI does not exist in table ANISCUSP. 
You must enter a valid ANI that exists in table ANISCUSP. 


An example of a Purge function with a target entry with no datafill, avimove 
Purge 2146110000 2146112211, obtains the following response: 
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The <to> ANI does not exist in table ANISCUSP. 
You must enter a valid ANI that exists in table ANISCUSP 


System action: 
A successful Purge function decreases the tuples in table 
ANISCUSP. 


User action: 
The user must confirm the removal of the entry from the database. 


Example when using the Status function 


The Status command displays a summary of the conversion. This command 
can be executed while the Total or Partial command is running to query the 
progress of the conversion. This command can be used to obtain the result of 
the last conversion once the conversion is completed. 


This section provides possible responses for example uses of the ANIMOVE 
command’s Status function. 


>ANIMOVE Status 


Responses for the Status function 


An example Status function for a total conversion in progress, ANIMOVE 
Status, obtains the following response: 


Conversion Type: Total 

Conversion Status: In progress 

Last ANISCUSP Tuple Converted: 2026262211 
Number of converted tuples from ANISCUSP: 87 
Number of tuples in ANIVAL: 87 

Number of tuples in UNIPROF: 87 


An example Status function for a complete Partial conversion, ANIMOVE 
Status, obtains the following response: 


Conversion Type: Partial 

Conversion Status: Complete 

Last ANISCUSP Tuple Converted: 2146112211 
Number of converted tuples from ANISCUSP: 150 
Number of tuples in ANIVAL: 150 

Number of tuples in UNIPROF: 60 
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ANIMOVE (continued) 


System action: 
None. 


User action: 
The Status function does not require user action other than entering 
correct syntax at the command line. 


Example when using the Halt function 


The Halt command stops either a Total or Partial ANIMOVE conversion 
that is in progress. 


This section provides possible responses for example uses of the ANIMOVE 
command’s Halt function. 


>ANIMOVE Halt 


Responses for the Halt function 


An example Halt function for a total conversion in progress, ANIMOVE Halt, 
obtains the following response: 


Conversion Type: Total 

Conversion Status: Halted 

Last ANISCUSP Tuple Converted: 2126222211 
Number of converted tuples from ANISCUSP: 390 
Number of tuples in ANIVAL: 390 

Number of tuples in UNIPROF: 390 


The ANIMOVE Halt command was issued. 


An example Halt function for a Partial conversion in progress, ANIMOVE 
Halt, obtains the following response: 


Conversion Type: Partial 

Conversion Status: Halted 

Last ANISCUSP Tuple Converted: 2136112221 
Number of converted tuples from ANISCUSP: 463 
Number of tuples in ANIVAL: 46 

Number of tuples in UNIPROF: 46 


The ANIMOVE Halt command was issued. 


System action: 
None. 
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User action: 
The Halt function does not require user action other than entering 
correct syntax at the command line. 


Related commands 
None 
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AUTHTEST 
Purpose 
The Authcode Test (AUTHTEST) command determines whether an 
authcode number exists in the service control point (SCP). 
Note: If the requested authcode exists, the related authcode data stored in 
the SCP displays. 
Access 
Accessible from any MAP level. 
Syntax 
>AUTHTEST authcode adin timeout 
Parameters 
Command parameters are described in Table 1-37. 
Table 1-37 
AUTHTEST parameter descriptions 
Parameter Values Description 
authcode 5 to 7 digits Specifies the authorization code associated with the 


account code to be validated or the speed number to 
be translated. 


adin 0 to 99 Specifies the authcode database index number. 
timeout 1 to 30 Specifies the wait time (in seconds) for a reply back 
(optional from the SCP. 
parameter 

—end— 


Example command 
>AUTHTEST 1234567 0 30 
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AUTHTEST (end) 


Responses 


The following is an example of a response to the AUTHTEST command: 


>AUTHTEST 5123456 4 3 
TIME FOR SENDING QUERY AND RECEIVING RESPONSE IS: 


CCOUUNT CODE LENGT 


IN LENGTH 
ULTIPLE PIN 
HOTLINE NUMBER 


SUVUVHOPPRPHH 


xx MINUTES, 
HE FOLLOWING DATA WERE RETURNED FROM THE SCP: 
HE AUTHCODE NUMBER 5123456 IS VALID 

CCOUNT CODE VALIDATION 


H 


RIGINATING PARTITION 
ERMINATING PARTITION 
RIVATE SPEED ALLOWED 


SATELLITE RESTRICTION 


FILED AUTHCODE ONLY 
AUTHCODE ABUSE TRAP 
SPLASHBACK CLASS 
TRAVEL ALLOWED 
CLASS OF SERVICE 
PIN LIST: 


Error messages 


xx SECONDS, xxxx MILLISECONDS. 


The following error messages may display as a result of the AUTHTEST 


command: 


Account code number out of range, >12 


Explanation: 


There is an error in the authcode data received from the SCP. 
Account code digits greater than 12 were entered. The command is 


ended. 


User action: 


Try the command again and verify the problem with the SCP. 


Related commands 


The AUTHTEST and TESTSS AUTHSS commands function in the same 
manner. The only difference in the two commands is how they are invoked 


at the MAP level. 
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Purpose 


The CLLI Reference Memberless (CLLIREF MEMBERLESS) command 
displays all the common language location identifiers (CLLI) without entries 
in table TRKMEM. This command is used to clean the CLLI database. 


Note: The CLLIREF tool is provided for information gathering purposes 
only. 


CAUTION 

Blindly deleting CLLIs is NOT recommended. 

The information generated by this tool may be used to 
guide maintenance activities; however, the ultimate safety 
of such activities is the responsibility of the user. 


Access 
Accessible from any MAP level. 


Syntax 
>CLLIREF MEMBERLESS output_device 


Parameters 
Command parameters are described in Table 1-38. 
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CLLIREF MEMBERLESS (continued) 


Table 1-38 
CLLIREF MEMBERLESS parameter descriptions 
Parameter Values Description 
output_device Valid values include: Specifies the name of output device. 
(optional 
parameter) e SFDEV Note: |f no output device name is entered, the 
© SINK information displays on the MAP screen. 


Note: The SINK 
option discards all 
tuple information. 


e device name 
(tape, printer, 
disk volume) 


—end— 


Example command 
>CLLIREF MEMBERLESS SFDEV 


Responses 


The following responses may display in response to the CLLIREF 
MEMBERLESS command: 


These TRKGRP CLLIs are not referenced by table TRKMEM. 
Caution: Some CLLIs are needed without trunk members. 
Memberless TRKGRP CLLIs: 

TERM102L 
TERM, 1000 
BBICBBOG 
CCS7 TL1 
CCS7 TL2 
DALO 
DALTIE 


Explanation: 
The system displays the TRKGRP CLLIs not referenced by table 
TRKMEM. 


User action: 
None 
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CLLIREF MEMBERLESS (ena) 


Error messages 
The following error messages may display as a result of the CLLIREF 
MEMBERLESS command: 


66,99 


Note: The system supplies the values represented by “x”. 


File system error: xxxxx 


Explanation: 
A file system error occurred while trying to create a file for storing 
the information to be gathered by CLLIREF. 


User action: 
Take the appropriate action based on the error message. 


WARNING: File xxxx already exists and will be overwritten. 
Please confirm (yes or no). 


Explanation: 

A filename matching the output file created by CLLIREF already 
exists on the device specified. This indicates that the information 
requested is probably already stored on the device. 


User action: 

To erase the previously existing file and create a new file, enter 
“Yes”. To abort the CLLIREF command and keep the existing file, 
enter “No”. 


Related commands 
The following commands relate to this command: 
e CLLIREF SEARCH—lists all CLLI references in the system data tables. 


This command allows the user to locate unused CLLI names and trunk 
groups. 


e TABREF CLLI—lists table types that use a CLLI. While most table 
names are equivalent to their corresponding table types, some table types 
must be translated to their respective table names. 
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CLLIREF SEARCH 


Purpose 
The CLLI Reference Search (CLLIREF SEARCH) command gathers 
information about specified common language location identifiers (CLLIs). 
CLLIREF SEARCH displays the tuples associated with a CLLI. This 
command is used to clean up the CLLI database. 


Restrictions 
Limitations associated with the CLLIREF SEARCH command include: 


e Tool is provided for information gathering purposes only. 


e Tool locates occurrences of fields of type COMMON_LANGUAGE 
_NAME in tables that are recognized users of countable type only. 


Note: There are a few tables that use CLLIs, but these are not 
recognized users of CLLIs. For example: tables TRKSGRP and 
TRKMEM are not recognized as users of CLLIs because they are 
dependent on table TRKGRP to be keyed by the CLLIs they use. 


CAUTION 

Blindly deleting CLLIs is NOT recommended. 

The information generated by this tool may be used to 
guide maintenance activities; however, the ultimate safety 
of such activities is the responsibility of the user. 


Access 

Accessible from any MAP level. 
Syntax 

>CLLIREF SEARCH clli_name ALL or table_name device 
Parameters 


Command parameters are described in Table 1-39. 
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CLLIREF SEARCH (continued) 


Table 1-39 
CLLIREF SEARCH parameter descriptions 
Parameter Values Description 
CLLI_ name 16 alphanumeric Specifies the valid CLLI name. 
characters 
ALL ALL Indicates all table names are searched. 
or or 
table_name 16 alphanumeric Indicates specific table names are searched. 
(optional characters 
parameter) 
output_device Valid values include: Specifies the name of the output device. 
(optional 
parameter) e SFDEV Note: |f no output device name is entered, the 
e SINK information displays on the MAP screen. 


Note: The SINK 
option discards all 
tuple information. 


e device name 
(tape, printer, 
disk volume) 


—end— 


Example command 
>CLLIREF SEARCH 250DAL ALL 


Responses 


After the CLLIREF SEARCH command successfully completes, the system 
displays the following response: 
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CLLIREF SEARCH (continued) 


clliref search 250dal 
CLLI ”250DAL” occurs in the following tuples: 


Table Key: Sub Tuple 
CLLI 250DAL 3995 24 $ 
TRKGRP 250DAL DAL 30 NPDGP NCIT 2W RLT2 MIDL 16 


7 16 16 S 7 NIL 

ID 0 7 111 MANUAL 214 0 6113311 RTE2 
0 3_1KHZ Y 1 N 

Y ANISNPA 00 160 (VANIDB ) $ 
CLLICDR 250DAL 3995 
TRKSGRP 250DAL 0 FXSLS STD 2W DT LS N 5 5 DT LS 6 
0 NNO NON N 
N M 7 UNEQ $ 


TRKMEM 250DAL 10 0 DTC 1 15 2 

TRKMEM 250DAL 11 0 DTCI 0 3 22 

TRKNAME 3995 250DAL 

TRKGRP1 250DAL DAL EAPT NOLOOK N 0 Y Y O NIL 0 0 
LLIMTCE 250DAL 250DAL 5 10 15 NSS 0 O N N (2) 
Total of 9 


occurrences of 250DAL 
> 


Error messages 
The following error messages may display as a result of the CLLIREF 
SEARCH command: 


66,92 


Note: The system supplies the values represented by “x”. 


File system error: xxxxx 


Explanation: 
A file system error occurred while trying to create a file for storing 
the information to be gathered by CLLIREF. 


User action: 
Take the appropriate action based on the error message. 


WARNING: File xxxx already exists and will be overwritten. 
Please confirm (yes or no). 


Explanation: 

A filename matching the output file created by CLLIREF already 
exists on the device specified. This indicates that the information 
requested is probably already stored on the device. 
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User action: 

To erase the previously existing file and create a new file, enter 
“Yes”. To abort the CLLIREF command and keep the existing file, 
enter “No”. 


Related commands 
The following commands relate to the CLLIREF SEARCH command: 
e CLLIREF MEMBERLESS—lists all CLLIs without trunk members 


defined in table TRKMEM. This command allows the user to remove 
unused CLLI names and trunk groups. 


e TABREF CLLI—lists table types that use a CLLI. While most table 
names are equivalent to their corresponding table types, some table types 
need to be translated to their respective table names. 
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Purpose (command level) 


The ECMON (Echo Canceller MONitor) command determines if the 
performance of the integrated echo canceller (EC) is acceptable. Use this 
command to request echo return loss (ERL) and echo return loss 
enhancement (ERLE) data for an individual channel of an NT6X50EC 
equipped port. 


Note: ERL measures the reflected energy level in relationship to the 
transmitted energy level. ERLE measures the attenuation of that reflected 
energy. An ERL reading is only valid for an “answered call”. An ERLE 
reading is meaningful only if the echo canceller is enabled to attenuate the 
ERL measured signal. 


EC Performance Monitoring options 
The following methods of EC performance monitoring are supported: 


e immediate, one-time reading of EC performance data 
e continuous EC performance monitoring 


e automatic EC performance monitoring of all NT6X50EC-equipped 
channels 


Immediate Read Performance Monitoring option 

The Immediate Read option requests ERL and ERLE readings for the 
specified trunk from an XPM. The XPM returns the requested data for the 
specified trunk (if valid) or the reason valid data was not supplied. ECMON 
displays the returned ERL/ERLE data and an evaluation of the quality of 
performance based on that data. If the data is not returned by the XPM, 
ECMON displays an explanation of the reason the data was not supplied. 


Log PM912 is output. This log contains information on each successfully 
processed ECMON command that changed the current monitoring state on a 
trunk circuit, XPM, or the system. (For more information on logs, see the 
UCS DMS-250 Logs Reference Manual.) 


Continuous Performance Monitoring option 

The Continuous Performance option allows continuous monitoring of EC 
performance for the specified trunk. This allows the EC’s performance to be 
monitored over a specified period of time without having to repeatedly enter 
the ECMON READ command. The XPM sends ERL and ERLE data to the 
computing module (CM) for each answered call placed over the monitored 
trunk when the EC is enabled. The specified trunk does not need to be 
involved in a call activation or deactivation of this function. 
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Log PM910 is output. This log contains the received data. (For additional 
information on logs, see UCS DMS-250 Logs Reference Manual.) 


Automatic Performance Monitoring option 

The Automatic Performance option performs automatic monitoring of all 
in-service NT6X50EC-equipped trunks. This background process verifies 
that the EC performances of these trunks are within expected parameters. 
When automatic monitoring detects a call with suspect EC performance, the 
process queries the performance of the suspect EC circuit three times within 
30 seconds. 


Log PM911 is output. This log records any suspect EC performance detected 
by the automatic monitoring process. (For more information on logs, see 
UCS DMS-250 Logs Reference Manual.) 


Command formats 
ECMON supports the following command formats: 


e trunk-based—initiates performance monitoring requests on a per-trunk 
basis 


e XPM-based—provides the following options: 


— disable continuous performance monitoring for all trunks assigned to 
the XPM 


— list all trunks with continuous performance monitoring that are active 
on the XPM 


e system-wide—disables or displays a list of all trunks, on a system-wide 
basis, with continuous monitoring enabled 


e automatic performance monitoring—enables/disables the automatic EC 
performance monitor 


Note: Log PM911 is output each time this command is entered to record 
the enabling and disabling functions. Log PM912 is output every eight 
hours indicating the current state (enabled or disabled) of the automatic 
echo canceller performance monitor process. 


Restrictions (command level) 
ECMON communicates with a software resident in a digital trunk controller 
(DTC) or an Integrated Services Digital Network (ISDN) DTC (DTCD. The 
required functionality is implemented via an XPM patch. For the ECMON 
command to function properly, the DTC must be loaded with software load 
ED705; the DTCI must be loaded with software load ELIO0S. 
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The following patches are required: 
e ED705-EDQ22+XDQ23 
e ECI05—XDQ24+XDQ25 


Access (command level) 
Accessible from any MAP level. 


Syntax (command level) 


Command syntax and parameters are dependent on the required command 
format. 


Syntax (trunk-based commands) 
>ECMON trunk_CLLI trunk_num option 


Parameters (trunk-based) 
Command parameters are described in Table 1-40. 


Table 1-40 
CLLIREF SEARCH parameter descriptions 


Parameter Values Description 
trunk_CLLI 16 alphanumeric Specifies the valid CLLI name. 
characters 


Note: Selected CLLI must be equipped with echo 
canceller (EC). 


table_num 0 to 9999 Specifies the valid number associated with trunk 
group member entered in the “trunk _CLLI” 
parameter. 


Note: DS1 span equipped with an internal echo 
canceller must be used. 


option Valid values include: 
e READ Displays immediate reading of ERL and ERLE data. 
e ON Enables continuous performance monitoring. 


—continued— 


Digital Switching Systems UCS DMS-250 Commands Reference Manual UCS17 


1-152 Commands 


Cl commands 
ECMON (continued) 


Table 1-40 
CLLIREF SEARCH parameter descriptions (continued) 


Parameter Values Description 
e OFF Disables continuous performance monitoring. 
e STATUS Displays continuous performance monitoring for a 


specified trunk. 


—end— 


Example command (trunk-based) 
>ECMON imtc7lany 63 READ 


Responses (trunk-based) 


Response parameters are described in Table 1-41. For more information on 
echo cancellation and ECMON, refer to the UCS DMS-250 NT6X50EC 
Integrated Echo Canceller Application Guide. 


Table 1-41 
ECMON trunk-based response parameter descriptions 


Parameter Description 

CLLI Specifies the trunk group associated with displayed data. 

Mem# Specifies the trunk group member number. 

XPM type Specifies the type of extended peripheral module (XPM) associated with 


trunk group. 
Note: Only DTC and DTCI XPMs are supported. 


XPM# Specifies the XPM number associated with the trunk. 

Carrier Specifies the T1 span/port associated with the trunk. 

Channel Specifies the T1 timeslot assigned to the trunk. 

ERL: xx dB Specifies the ERL reading returned by the XPM. 
—end— 
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Table 1-41 


ECMON trunk-based response parameter descriptions (continued) 


Parameter Description 
ERLE: xx dB Indicates the ERLE reading returned by XPM. 
Text Provides the message explaining the results of the ECMON request and 


any user actions (if required). 


—end— 


After the ECMON command completes, the results and/or message 
responses are displayed on the MAP terminal that originated the request. An 
example of a response to an ECMON trunk-based READ command follows: 


>ECMON imtc7lany 63 READ 

ERL:<CLLI><MEM NUM>-<XPM TYPE><XPM NUM> CARRIER<#> CHANNEL<#> 
ERLE:8 dB ERLE: 27dB 

Echo canceller performing within expected limits. 


Note: Additional responses are dependent on which trunk-based ECMON 
option is selected: 


READ option responses (trunk-based) 
The following are responses to the READ option: 


<CLLI> <CLLI Mem>- 
<XPMtype> <#>carrier <#>channel <#> 
ERL=xxdB ERLE=xxdB 


Echo canceller performing within expected limits. 


Explanation: 
Displayed if the query is successful and the sum of ERL and ERLE 
is at least 30 dB. 
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<CLLI> <CLLI Mem>- 

<XPMtype> <#>carrier <#>channel <#> 

ERL: xxdB ERLE: xxdB 

Potential network problem; ERL should be at least 6 dB. 


Explanation: 

The ERL measured by the NT6X50EC is less than 6 dB. This may 
indicate a problem within the network. An ERL of at least 6 dB is 
required for the NT6X50EC to cancel echo properly. 


User action: 
Determine the reason ERL is less than 6 dB and correct the problem. 
Repeat the command to verify the results. 


<CLLI> <CLLI Mem>- 
<XPMtype> <#>carrier <#>channel <#> 
ERL: xxdB ERLE: xxdB 


Potential echo cancellation problem; ERL + ERLE <30 dB. 


Specified trunk is not involved in an answered call: 
Selected trunk is not involved in a a call. Request for 
immediate READ denied. 


Explanation: 

The ERL read by the NT6X50EC is at least 6 dB and the echo 
canceller is activated, but the total echo return loss plus enhancement 
is less than 30 dB. This may indicate a potential problem with echo 
cancellation on the NT6X50EC. 


User action: 
Troubleshoot possible source of echo cancellation problem. Repeat 
the command to verify results. 
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<CLLI> <CLLI Mem> - 
<XPMtype> <#>carrier <#>channel <#> 
Invalid ERL/ERLE readings. Please try again. 


Explanation: 

The data is flagged as invalid in the response message from the 
XPM. This can occur if the input signal amplitude to the echo 
canceller is too low, the ERL is too low, or there is an echo 
suppressor in the transmission path. 


User action: 

Verify there is no external echo suppressors in the transmission path. 
Also verify multiple echo cancellers are not active on the call. Repeat 
the command to verify results. 


<CLLI> <CLLI Mem> - 
<XPMtype> <#>carrier <#>channel <#> 
Request denied 


Explanation: 

The XPM is monitoring or reading ERL and ERLE data for another 
channel on the same carrier (monitored channel information 
displays). The echo canceller monitor is active on the trunk. 


User action: 


Reset values (if required) 


<CLLI> <CLLI Mem> - 
<XPMtype> <#>carrier <#>channel <#> 


2100 Hz tone detected - Echo canceller disabled. 


Explanation: 

The NT6XS50EC has disabled echo cancellation on the specified 
trunk. This is because it detected 2100 Hz tone, which indicates the 
call is a data call. 


User action: 
None 
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<CLLI> <CLLI Mem> - 
<XPMtype> <#>carrier <#>channel <#> 


Echo canceller not enabled on selected trunk. 


Explanation: 

Echo cancellation is not enabled for the selected trunk. This can 
occur if the specified trunk releases from the call while the readings 
are being retrieved or the specified trunk is involved in a call where 
it is not the end circuit in the call. 


User action: 
Verify whether it is appropriate for the NT6X50EC echo canceller 
not to be activated for the subject call. 


Already processing request for trunk. 


<CLLI> <CLLI Mem> - 
<XPMtype> <#>carrier <#>channel <#> 


Request denied. Echo canceller monitoring already active on 


trunk: 


Explanation: 

A request for another trunk on the same carrier is already in progress 
in the XPM. Continuous monitoring may be active on a different 
trunk assigned to the same carrier as the requested trunk or another 
user may have requested a reading on a different trunk assigned to 
the same carrier. Monitored trunk information displays. 


User action: 

Determine if continuous monitoring is enabled for a different trunk 
or if another user is requesting a reading. Clear the conflict and try 
the command again. 


Processing another request for this trunk. 


Explanation: 

The XPM is processing another request on the specified trunk. The 
XPM can process only one request on an NT6X50EC-equipped port 
at a time. This request came in second and was rejected. 


User action: 
Try the request again after a 5- to 10-second delay. 
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Selected trunk is not involved in a call. Request for 
immediate READ denied. 


Explanation: 

The specified trunk is not involved in a call; therefore, the echo 
canceller is not enabled. The request for ERL/ERLE data is only 
reasonable if the echo canceller is activated. 


User action: 
Wait until the selected trunk is involved in an answered echo 
canceller-enabled call and then enter the command again. 


ON option responses (trunk-based) 
The following are responses to the ON option: 


Continuous monitoring enabled. <CLLI><MEM#>— 
<XPMTYPE><XPM#> CARRIER<#> CHANNEL<#> 


Explanation: 

A request to continuously monitor the echo canceller performance 
for the specified trunk was successfully processed. The specified 
trunk was not involved in an answered call at the time of the request. 


User action: 
None 


Continuous monitoring enabled. <CLLI><MEM#>— 
<XPMTYPE><XPM#> CARRIER<#> CHANNEL<#> 


ERL: 


xxdB ERLE: xxdB 


Echo canceller performing within expected limits. 


Explanation: 

A request to continuously monitor the echo canceller performance 
for the specified trunk was successfully processed. The specified 
trunk was involved in an answered call at the time of the request. 


User action: 
None 
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Already monitoring specified trunk. <CLLI><MEM#>— 
<XPMTYPE><XPM#> CARRIER<#> CHANNEL<#> 
No action taken. 
Explanation: 
Continuous performance monitoring is already active on the 
specified trunk. 


User action: 
Verify the correct trunk was entered in the request. If not, enter the 
correct trunk. 


Continuous performance monitor active on trunk: 
<CLLI><MEM#>— 

<XPMTYPE><XPM#> CARRIER<#> CHANNEL<#> 

No action taken. 


Explanation: 

Continuous performance monitoring is already active for another 
trunk on the same carrier. Only one trunk circuit of an 
NT6X50EC-equipped carrier port can be monitored at a time. 


User action: 
None 


OFF option responses (trunk-based) 
The following are responses to the OFF option: 


Continuous monitoring disabled. 
<CLLI><MEM#>-— 
<XPMTYPE><XPM#> CARRIER<#> CHANNEL<#> 


Explanation: 
The request to disable continuous monitoring of echo canceller 
performance was successfully processed for the specified trunk. 


User action: 
None 
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Continuous monitoring not active on specified trunk. 
<CLLI><MEM#>— 

<XPMTYPE><XPM#> CARRIER<#> CHANNEL<#> 

No action taken. 


Explanation: 
The user tried to cancel continuous performance monitoring on a 
trunk that was not being continuously monitored. 


User action: 
Verify the trunk entered was correct. If not, enter the command 
again. 


STATUS option responses (trunk-based) 
The following are responses to the STATUS option: 


Continuous monitoring active. 
<CLLI><CLLI MEM>-— 
<XPMTYPE><XPM#> CARRIER<#> CHANNEL<#> 


Explanation: 
The status of a trunk is being monitored continuously. 


User action: 
None 


Continuous monitoring not active. 
<CLLI><MEM#>— 
<XPMTYPE><XPM#> CARRIER<#> CHANNEL<#> 


Explanation: 
The status of a trunk is not being monitored continuously. 


User action: 
None 
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Error messages (trunk-based) 


The following error messages may display as a result of trunk-based 
ECMON commands: 


<Trunk_num> is not a valid number. 


Check 


Explanation: 
The second parameter entered was a number larger than 9999. The 
valid range for CLLI trunk group member numbers is 0 to 9999. 


User action: 
Enter the command again with a valid CLLI group member number. 


service state of target equipment. 


<CLLI> <CLLI Mem> — 
<XPMtype> <#>carrier <#>channel <#> 
Try again when all related equipment in-service. 


Explanation: 
The required equipment necessary for communicating with the 
appropriate XPM is out of service. 


User action: 

Verify all associated equipment is in service. Restore all associated 
equipment that is not in service before trying the command again. 
Notify ETAS of the problem if all required equipment is already in 
service. 


Format is ECMON <trunk CLLI> <number> <on|OFF|READ|STATUS>. 


Explanation: 
The values for the CLLI command format of the ECMON CI 
command are: READ, ON, OFF, and STATUS. 


User action: 
Enter the command again with a valid value for the third parameter. 
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Missing command parameters 
Correct format is: 


ECMON 


<CLLI> <number> <on|OFF|READ|STATUS>. 


Explanation: 

The ECMON CI command CLLI format requires the following 
parameters: trunk CLLI, trunk CLLI member number, and function 
to perform. Function values are: READ, ON, OFF, and STATUS. 


User action: 
Enter the command again with the correct number of input 
parameters. 


Specified CLLI is not a valid short or full CLLI: 
<input CLLI> is not a valid trunk group CLLI. 


Explanation: 
The trunk group CLLI specified in the ECMON command is not 
valid. 


User action: 
Determine the correct CLLI for the trunk and try the command again. 


Specified trunk does not exist. 


Timed 


Explanation: 
The trunk member number specified in the ECMON command does 
not exist in table TRKMEM. 


User action: 
Determine the correct trunk member number and enter the command 
again. 


out waiting for response from <XPM TYPE> <XPM#>. 


Explanation: 

No response or a late response was received from XPM. The 
ECMON CI waits ten seconds for the XPM reply before issuing this 
response. Possible reasons for the time-out could be because of high 
call processing requirements on either the CM or XPM. 


User action: 
Try the command again. Verify the destination XPM is functional. 
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Trunk 


circuit assigned to unsupported XPM type. 


<CLLI><MEM#>— 
<XPMTYPE<XPM#> CARRIER<#> CHANNEL<#> 


Trunk 


Trunk 


Explanation: 
The specified trunk is not assigned to either a DTC or DTCI. 


User action: 

Verify the input CLLI and CLLI member number. If correct, verify 
the specified trunk is datafilled for internal echo cancellers. Correct 
the datafill for the specified trunk group as required. Enter the 
ECMON command again with the correct parameters. 


not assigned to NT6X50EC equipped channel. 


Explanation: 

The specified trunk is not datafilled on a DTC span whose carrier 
maintenance datafill indicates the card code is NT6X50EC. The 
entry for the XPM span in table LTCPSINV must point to an entry in 
table CARRMTC; this table identifies the card type as NT6X50EC. 


User action: 


Correct the datafill for the desired trunk group if appropriate. Enter 
the ECMON command again with the correct parameters. 


not datafilled for internal echo cancellation. 


<CLLI><MEM#>— 
<XPMTYPE<XPM#> CARRIER<#> CHANNEL<#>> 


Explanation: 

The specified trunk is not set for internal echo cancellation. The 
ECSTAT field in table TRKSGRP is not set to INTERNAL or 
INNOTONE. 


User action: 

Verify the input CLLI and CLLI member number. If correct, verify 
the specified trunk is datafilled for internal echo cancellers. Correct 
the datafill for the specified trunk group as required. Enter the 
ECMON command again with the correct parameters. 


Unexpected response received. Please try again 
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Explanation: 


The response received from the XPM does not match any of the 
expected responses. 


User action: 


Record any pertinent call scenario information and verify the error is 
repeatable. Notify ETAS of the problem. 


Syntax (XPM-based commands) 
>ECMON XPM type XPM number option 


Parameters (XPM-based) 
Command parameters are described in Table 1-42. 


Table 1-42 
ECMON XPM-based parameter descriptions 
Parameter Value Description 
XPM type DTC Indicates type of XPM that performs the operation. 
or 
DTCI Note: Only DTC and DTCI XPMs are supported. 
XPM number 0 to 255 Indicates the XPM destination number. 
option Valid values include: 


-° OFF 


e STATUS 


e Disables continuous performance monitoring for 
all trunks located on the specified XPM. 


Note: The user is prompted to verify a request 
before its executed. 


e Lists trunks assigned to the specified XPM with 
continuous performance monitoring active. 


—end— 
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ECMON (continued) 


Responses (XPM-based) 


The following is an example of a response to an XPM-based ECMON 
command: 


>ECMON DTCI 63 OFF 
This will disable continuous monitoring on <XPM TYPE> <xPM#> 
Do you wish to continue? (Yes, Y, No, N) 


>YES 


Continuous monitoring disabled for DTCI 63.. 


The following are possible responses to the XPM-based command: 


Continuous monitoring active on the following trunks: 
<CLLI> <member> <XPM type> 
<XPM number> <carrier> <channel> 


Explanation: 

The request to list all trunks with continuous echo canceller 
performance monitoring active on the specified XPM was 
successfully processed. 


User action: 
No action required. This is an expected response. 


Continuous monitoring disabled for 
<XPM type> <XPM number> 


Explanation: 

The request to disable continuous monitoring of the echo canceller 
performance for all trunks on the specified XPM was successfully 
processed. 


User action: 
No action required. This is an expected response. 


Error messages (XPM-based) 


The following error messages may display as a result of the XPM-based 
command: 


<Parm 3> is not a valid option. Valid options are OFF or 
STATUS. 
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Explanation: 
The third parameter entered was not one of the allowed values for the 
XPM-based command format. Valid values are OFF or STATUS. 


User action: 
Enter the command with a valid DTC number for the third parameter. 


<Parm 2> is not a valid XPM number. 


Explanation: 

The second parameter of XPM-based commands specifies the XPM 
number. The ECMON command determined the second parameter 
specified is not a valid XPM number. 


User action: 
Enter the command with a valid XPM number for the second 
parameter. 


<<XPM type> <XPM number> not equipped. 


Explanation: 
The specified XPM is not equipped. 


User action: 
Equip the specified XPM or verify the proper XPM type and number 
before entering the command option. 


Check service state of <XPM TYPE> 
Try again when all related equipment is in-service. 


Explanation: 
The specified XPM is not in service. 


User action: 
Restore the specified XPM and try the command again. 


Command option missing. Valid options are OFF or STATUS. 


Explanation: 
The third parameter was not entered. It is needed for XPM command 
formats. 


User action: 
Enter the command with a valid DTC number for the third parameter. 
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No trunks being monitored on <XPM type> <XPM number> 


Explanation: 

A list of all trunks with continuous performance monitoring active 
request is received. This response is sent to the requesting MAP 
terminal when no trunks are being performance monitored. 


No NT6X50EC equipped on <XPM type> <XPM number>> 


Explanation: 
No NT6X50EC circuit packs are equipped in specified XPM. 


User action: 

Verify at least one NT6X50EC circuit pack is equipped in specified 
XPM. If hardware is present, verify the datafill for tables LTCPSINV 
and CARRMTC. 


Only DTC and DTCI peripherals are supported by this command. 


Explanation: 
This command only supports DTC and DTCI XPMs equipped with 
NTO6XS50EC circuit packs. 


User action: 
Try the command again with a supported XPM type. 


Syntax (system-wide commands) 
>ECMON option 


Parameters (system-wide) 
Command parameters are described in Table 1-43. 
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Table 1-43 
ECMON system-wide parameter descriptions 
Parameter Value Description 
option Valid values include: 
e OFF e Disables continuous performance monitoring for 
all NT6X50EC equipped trunks located on the 
specified XPM. 


Note: The user is prompted to verify a request 
before its executed. 


e STATUS e Displays all NT6X50EC equipped trunks with 
continuous performance monitoring active. The 
output is generated on an XPM basis in 
ascending carrier port order. 


—end— 


Example (system-wide) 
>ECMON OFF 


Responses (system-wide) 


If the ECMON command uses the system-wide command format, the system 
may display one of the following informational or error message responses: 


Continuous monitoring active for trunks <CLLI> <member>-<XPM 
type> <XPM number> <carrier> <channel> 


Explanation: 
The request to list all trunks with continuous echo canceller 
performance monitoring active was successfully processed. 


User action: 
None 


Continuous monitoring not active on any trunks. 


Explanation: 

The message indicates a successful response to a request to list all 
trunks with continuous performance monitoring active when there 
are no trunks being monitored. 
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ECMON OFF processing started. Continuous monitoring disabled 
<XPM type> <XPM number> 

Request not processed for <XPM Type> <XPM #>, not in service. 
Internal resource error, request failed for <XPM Type> <XPM 
#> 

Unexpected reply received, request failed for <XPM Type> <XPM 
#> 

No NT6X50EC equipped XPMs found. ECMON OFF processing 
completed. 


Explanation: 
The request to disable continuous monitoring of the echo canceller 
performance for all trunks on the system was successfully processed. 


Internal resource unavailable, request aborted. 


Explanation: 

An error was encountered by the ECMON CI process while trying to 
send a request to the program that processes the disable all 
continuous monitoring active in an XPM. 


Auto-monitoring commands 


>ECMON function option 


Parameters (auto-monitoring) 


Table 1-44 


Command parameters are described in Table 1-44. 


ECMON auto-monitoring parameter descriptions 


Parameter Value Description 
function AUTO Automatic monitoring of the EC performance is active 
option Valid values include: 


e ON e Enables the automatic EC performance 
monitoring process. 


—continued— 
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ECMON (continued) 


Table 1-44 
ECMON auto-monitoring parameter descriptions (continued) 
Parameter Value Description 

e OFF e Disables the automatic EC performance 
monitoring process. 

e STATUS e Identifies the current state of the automatic EC 
performance monitoring process (enabled or 
disabled). 

—end— 


Responses (auto-monitoring) 
The following are the possible responses to the auto-monitoring command: 


<Parm 2> is not valid. Valid options are ON, OFF, or STATUS. 


Explanation: 
The second parameter entered was not one of the acceptable values 
(ON, OFF, or STATUS). 


User action: 
Enter correct value. 


Automatic Echo Canceller performance monitoring already 
disabled. 


Explanation: 
The request to turn off automatic Echo Canceller performance 
monitoring was received, but the process was already disabled. 


User action: 
Enable monitoring (if required). 


Automatic Echo Canceller performance monitoring already 
enabled. 


Explanation: 
The request to turn on automatic Echo Canceller performance 
monitoring was received, but the process was already enabled. 
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ECMON (continued) 


User action: 
None 


Automatic echo canceller performance monitoring disabled 


Explanation: 
The request to disable automatic echo canceller performance 
monitoring was successfully processed. 


User action: 
None 


Automatic echo canceller performance monitoring enabled 


Explanation: 
The request to enable automatic echo canceller performance 
monitoring was successfully processed. 


User action: 
Enter the command again with the correct input. 


Missing command option. Valid options are ON, OFF, or STATUS. 


Explanation: 


One of the following parameters must be entered: ON, OFF, or 
STATUS. 


User action: 
Enter the command again with the correct input. 


Responses (command level) 
Error messages 


The following general error messages may display as a result of the 
ECMON command: 


<XPM TYPE><XPM #> is not valid. 


Explanation: 

An invalid input parameter was received by the program that 
processes ECMON CI command requests. These errors should be 
detected by the CI command before the request is sent to the program 
that actually processes the request. 
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ECMON (continued) 


User action: 
Try the command again. If this error repeats, notify ETAS of all 
details of the error. 


Internal data error detected. Please try again later. 


Explanation: 
An internal table data inconsistency was detected. An audit of the 
internal tables has been scheduled. 


User action: 
Wait (approximately 10 minutes) for the internal audit to finish and 
try the command again. If the problem persists, contact ETAS. 


Internal resource unavailable. Request aborted. 


Explanation: 

The ECMON command draws from a pool of internal resources to 
accomplish its task. This response is displayed at the MAP terminal 
if the internal resources are not available when the ECMON 
command is issued. 


User action: 
Try the command again. If the problem persists, notify ETAS. 


Note: The ECMON CI command is restricted to 50 instances of the 
command being active at one time. This error message displays at the 
requesting MAP terminal after the 51st attempt. 


Wait until there are less than 50 MAP terminals using this command, 
then try it again. Notify ETAS if less than 50 instances of the 
ECMON command are active when this error message is received. 


Invalid carrier channel, <channel number>, received. 


Explanation: 

An invalid input parameter was received by the program that 
processes ECMON CI command requests. These errors should be 
detected by the CI command before the request is sent to the program 
that actually processes the request. 


User action: 
Try the command again. If this error repeats, notify ETAS of all 
details of the error. 
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ECMON (end) 


Not assigned — <XPM type> < XPM number> <carrier> <channel>> 


Explanation: 

A translation error occurred when converting the XPM number, 
carrier number, and carrier channel number data contained in an 
XPM response message to its CLLI and CLLI member number. 


User action: 

Verify the data contained in tables CLLI and TRKMEM is valid for 
the displayed XPM carrier and channel. Correct any table entry in 
error. Notify ETAS if the table data is already correct. 


Unexpected message received, <msg#> 
Explanation: 
An unexpected reply message was received. 


User action: 
Notify ETAS. 


Unexpected response received. 


Please try again. 


Explanation: 
The program that processes ECMON CI command requests sent an 
unknown message to the ECMON CI process. 


User action: 


Try the command again. Notify ETAS if the problem persists. 


Related commands 
None 
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LISTAB 


Purpose 


Restrictions 


Access 


Syntax 


Parameters 


The List Table (LISTAB) command displays the number of “listabs” 
associated with each of the thirteen listab “pools”. 


Note: A “listab” is the internal data structure that physically stores routing 
information in the UCS DMS-250 switch. Each “listab pool” contains up to 
65520 listabs (64Kbytes per listab). 


Available listab pools include: 


e pools 1-12—dedicated to Table Route Reference (RTEREF) in table 
Home Numbering Plan Control (HNPACONT) 


e pool 0—used by all other tables using listabs 


When Serving Translation Scheme (STS) values are added to table 
HNPACONT, the RTEREF subtable is added to a listab pool. The RTEREF 
subtable for that STS may neither overflow into another pool nor move to 
another listab pool unless the STS is deleted and added again. 


Accessible from any MAP level. 


>LISTAB 


None 


Example command 


>LISTAB 
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LISTAB (end) 


Responses 


After the LISTAB command successfully completes, the system displays a 
response similar to the following: 


>LISTAB 

POOL Listabs in use Listabs available 
(0 44275 21245 
1 1491 64029 
2 1410 64110 
3 1897 63623 
4 1758 63762 
5 1607 63913 
6 1656 63864 
7 1330 64190 
8 1543 63977 


LISTAB POOLS 1 THROUGH 12 ARE DEDICATED TO HNPACONT TABLE 
LISTAB POOL 0 IS USED BY ALL OTHER TABLES USING LISTABS 


Related commands 
None 
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Purpose 


The NOO Test (NOOTEST) command tests the NOO Transaction Capability 
Application Part (TCAP) subsystem. This is done by manually initiating 
NOO TCAP queries for a specified calling number and NXX number. 


NOOTEST uses an NOO TCAP invoke message through a service control 
point (SCP) to test the following: 


e Automatic Number Identification (ANI) numbers on Feature Group 
(FGD) Equal Access Network Trunk (EANT) trunks 


e Pseudo Automatic Number Identification (PANT) numbers on NOO 
remotely translated PANI on the following: 


— Direct Access Line (DAL) 
— Offnet Access Line (ONAL) 
— Offnet Access Trunk (ONAT) 


NOOTEST also displays automatic code gapping (ACG) responses sent back 
from the service control point (SCP). 


Restrictions 
Limitations associated with the use of the NOOTEST command include: 


e Prerequisites 
— NOO subsystem must be in service. 
— SCP is operational. 
— All other system responses have not changed. 
Note: NOOTEST is available only when the SOC option “NOOR 
NOO/NXX TCAP Service” (NOORO002) is set to ON. 
e PANI call processing 


— System does not screen the personal identification number (PIN) for 
PANI calls. 


— All PANIs are validated in the ANI database. 


— Ifa N00 ES SACREMOT call originates on a PANI trunk, and the 
system is not set for enhanced NOO logic, the first three digits of the 
PANI are sent to the SCP. Ten digits are sent only when the system is 
set for enhanced NOO logic. 
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NOOTEST (continued) 


Syntax 


Trunking requirements 


— If the call originates on a DAL, ONAL, or ONAT trunk, the call is 
handled as a PANI call. 


— If the call originates on an EANT trunk, the switch first attempts to 
collect a 10-digit ANI, then a 6-digit ANI, then a 3-digit ANI. If ANI 
digits are not available, the switch sends the serving number plan 
area (SNPA) from the TRKGRP table. 


— NOO origination on DAL trunks is limited to 700 and 800 prefixed 
calls. 


Message format 

— If the switch is expecting one type of message format from the SCP 
and receives a different type, the message is considered erroneous. 

Office parameters 


— ENHANCED_NO0_TCAP (table OFC VAR) must be datafilled to 
indicate the one of the following ANI formats: 


_ 3-digit ANI 
- 6-digit ANI 
— 10-digit ANI 


— REDIR_ENHANCED_NO0_TCAP (table OFCVAR) must be 
datafilled to indicate whether the value of the command line 
parameter Redirection is sent in the TCAP query. 


>N00 TEST ani n0O_number timeout redirection 


Parameters 


Command parameters are described in Table 1-45. 
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NOOTEST (continued) 
Table 1-45 
NOOTEST parameter descriptions 
Parameter Values Description 
ani NPA-NXX-XXX Indicates the ANI number. 
(3-, 6-, or 10-digits) 
Note: When the 10-digit ANI is used, office 
parmameter ENHANCED_NO0O_TCAP (table 
OFCVAR) must be set to ”Y” to indicate an enhanced 
NOO TCAP invoke component is being sent. 
n0O_number NXX-NXX-XXXX Specifies the ten-digit NOO number. 
(10-digits) 
timeout 1 to 30 Specifies the wait time (in seconds) for a reply back 
(optional from the SCP. 
parameter) 
Note: |f a value is not entered, the system pulls the 
default value defined for NOO SCP_RESPONSE _ 
TIMEOUT (table OFCVAR). 
redirection Valid values include: Determine if the NOO query results does/does not 


e Y 
e N 
(default) 


result from the consult leg of a redirected call. 


Note: The default is used if the REDIRECTION 
parameter is not specified or if the REDIR_ 
ENHANCED_NOO_TCAP parameter (table OFCVAR) 
is set to “False”. The REDIRECTION parameter is 
used if REDIR_-ENHANCED_ NOO_TCAP is set to 
“True”. 


—end— 


Example command 
>NOOTEST 214907 900990123433 5 Y 


Responses 


After the NOOTEST command successfully completes, the system displays 
one of the following responses: 


66.99 


Note: The system supplies the values represented by “x”. 


Digital Switching Systems UCS DMS-250 Commands Reference Manual UCS17 


1-178 Commands 


Cl commands 


NOOTEST (continued) 
The following data were returned from the SCP: 
The NOO number translates to: XXXXXXXXX 
Called party billing: XXX 
CPI provided: XX 
Satellite restriction: XX 
Nature of number: XX 
Originating partition: XXX 
Terminating partition: XXX 
Bearer capability code: XXXXXXXXXXX 


Translation billing type: xx 


Explanation: 
The system displays the information received from the query. 


User action: 
None 


THIS NOO NUMBER CURRENTLY HAS ACG CONTROLS APPLIED. THE CALL 
WOULD BE ROUTED TO THE TREATMENT INDICATED BY THE OFFIC 
PARAMETER NOO_ACG_TRMT IN TABLE OFCVAR. 

CURRENTLY NOO_ACG_TRMT IS NOO_CALL BLOCKED. 

THE FOLLOWING DAT AIS CURRENTLY IN THE CONTROL LIST WITH 
AUTOMATIC CODE GAPPING (ACG) INVOKED: 

CONTROL CODE: <control code> 

CONTROL CAUSE INDICATOR: <control cause indicator> 

GAP VALUE: XXXX 

DURATION VALUE: XXX 


Gl 


Explanation: 
The NOO number currently has ACG applied. 


User action: 
None 
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NOOTEST (continued) 


TIME FOR SENDING QUERY 


AND RECEIVING RESPONSE IS: 


Y SECONDS, Z MILLISECONDS 
THE CALL WOULD BE ROUTED TO THE TREATMENT INDICATED IN THE 
OFFICE PARAMETER NOO_ACG_TRMT IN TABLE OFCVAR. 


CURRENTLY NOO_ACG_TRMT 


IS NOO_CALL_ BLOCKED. 


THE FOLLOWING DATA WER 


E RETURNED FROM THE SCP IN T 


AUTOMATIC CODE GAPPING 
CONTROL CODE: <control 
CONTROL CAUSE INDICATO 
GAP INDEX: XXXSEC 


(ACG) COMPONENT: 
code> 
R: <control cause indicator> 


DURATION SECONDS: XXXSEC 


Explanation: 


X MINUTES, 


HE 


A response to an NOO TCAP invoke with the ACG component 
returned. The NOO number does not have ACG applied. The ACG 
component is returned from the SCP. 


User action: 
None 


Time for sending request and receiving response is: 


minutes, x seconds, x milliseconds. 
The following data were returned from the SCP: 


The NOO translates to: 
Called party billing 
Satellite restriction: 
Nature of number: 
Originating partition: 
Terminating partition: 


Explanation: 


XXXXXXX 


The system displays the time it took to send the request and receive a 
response. In addition, the system responds with other information 
available in the remote database. 


User action: 
None 
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NOOTEST (continued) 


WARNING:::Number of NOO digits is x. The acceptable number is 
10, but the query is sent to the DCP anyway. 


Explanation: 
Even though the NOO number contains more or less digits than the 
required amount (10) the query is sent to the SCP. 


User action: 
None 


Error messages 


The following error messages may display as a result of the NOOTEST 
command: 


66,92 


Note: The system supplies the values represented by “x”. 


Could not decode the received message. 
Explanation: 
The TCAP decoder has failed to decode the received message. 


User action: 
Validate message parameters and resend (if required). 


Encoder failed to assemble the query. 
Explanation: 
The query is aborted. 


User action: 
Try the query again. 


Invalid digits in ANI. 


Explanation: 
The acceptable digits are numeric digits only from 0 to 9. Any other 
characters are rejected. 


User action: 
Enter the valid digit value. 
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NOOTEST (continued) 


Invalid digits in the called number. 


Explanation: 
The acceptable digits are numeric digits only from 0 to 9. Any other 
characters are rejected. 


User action: 
Enter the valid digit value. 


NOOTEST can only be used when SOC option NOOROO002 is ON. 


Explanation: 

The service optionality control (SOC) option NOORO002 “NOOR 
NOO/NXX TCAP Service” implemented by this feature is not ON. 
NOOTEST may only be used when the SOC option is ON. The 
command is not processed. 


User action: 
Set SOC to ON. 


Note: For additional information, see the DMS-100 Family Software 
Optionality Control User’s Manual. 


No response within office assigned timeout. Timeout value is: 
x seconds. 


Explanation: 
There is no response from the remote database within the assigned 
timeout period. 


User action: 

Assign a larger timeout value. This value can be up to 30 seconds. 
Numbering plan is not telephony or digits are not TBCD. 

Explanation: 


The numbering plan and encoding scheme are incorrectly formatted. 


User action: 
Enter valid values. 
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NOOTEST (continued) 


Parameter set is not a private TCAP. 


Explanation: 
The expected component is private and the received component is 
national. 


User action: 
Enter valid values. 


Parameter set is not a private TCAP. 


Query 


Query 


Explanation: 
The expected component is private and the received component is 
national. 


User action: 
Enter valid values. 


could not be sent to DCP. 


Explanation: 
The query is aborted. 


User action: 
Try the query again and save the software error report for resolution 
of the problem. 


is blocked by the DCP. 


Explanation: 
The query is not translated. 


User action: 
Enable query. 


The component is not a national TCAP type. 


Explanation: 
The expected component is national and the received component is 
private. 


User action: 
Enter valid values. 
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NOOTEST (continued) 


The component is not recognized. 


Explanation: 

The following response messages are valid for TCN validation: 
INVOKE (last), REJECT, and ERROR. Any other types of responses 
received for NOO are invalid. 


User action: 
Enter valid value. 


The message received from the DCP is an error message. 
Explanation: 
The received message is an error message generated by the SCP. 


User action: 
None 


The message received from the DCP is a reject message. 
Explanation: 
The received message is a reject message. 


User action: 
None 


The NOO application subsystem does not exist. 


Explanation: 
The TCAP software currently is not supporting the NOO application 
subsystem. 


User action: 
Check with switch administration for the proper software load. 


The NOO parameter has incorrect number of digits. 


Explanation: 
The NOO number consists of ten digits. Any digit length other than 
10 is considered an error. 
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NOOTEST (continued) 


The NOO subsystem is out of service. 
Explanation: 
This subsystem is currently out of service. 


User action: 
Return the subsystem to service. 
The operation parameter is not a connection control type. 


Explanation: 
The operation group of the received message is not coded as 
connection control type. The message is rejected. 


User action: 
Enter valid value. 
The parameter group is not a private TCAP type. 


Explanation: 
The parameter group of the received message is not coded as private 
TCAP parameter. A private parameter is expected. 


User action: 
Enter valid values. 

The queried number does not exist in the DCP database. 
Explanation: 


The calling number does not exist in the SCP database. 


User action: 
Verify the calling number is entered properly. 


The query is blocked by the DCP — It is not translated. 


Explanation: 
The queried number exists in the SCP, but the record is blocked from 
being translated. 


User action: 
Verify the cause of blockage. 
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NOOTEST (continued) 


The response component is not an invoke operation. 


Explanation: 

The system received an invoke from the SCP instead of the expected 
response. This is a script error between SSP and SCP nodes. The 
message is rejected. 


User action: 
Determine cause of error message and correct. 


The response contains incorrect number of digits. 


Explanation: 
The number of digits in the parameter of the received message is not 
enough. The expected length is 7 or 10 digits. 


User action: 
Enter valid value. 


The translated digit group is not a routing digit type. 


Explanation: 
The parameter should contain a routing digit. The message is 
rejected. 


User action: 
Enter valid value. 


Too many users are logged on to TESTSS. 


Explanation: 

Too many people are using the TESTSS command. The number of 
people allowed to use the TESTSS command is defined in the 
TESTSS250_MAX_USERS office parameter. Try the TESTSS 
command later. 


User action: 
Check the office parameter TESTSS250_MAX_USERS and verify it 
is sufficient. 
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NOOTEST (end) 


Invalid optional parameter: Redirection (Y or N) 
Explanation: 
Incorrect value; should be Y or N. 


User action: 
Enter valid value. 


Related commands 
Use the TESTSS command to verify the integrity of a subsystem. 


Use the POST command to post the subsystem to be tested. The subsystem 
must be local. 
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QACCT 
Purpose 
The Query Account (QACCT) command manages information located in the 
account code screening (ACSCRN2) table. 
Note: QACCT replaces the ACDQUERY command. 
Access 
Accessible from any MAP level. 
Syntax 
>QACCT HELP topic 
>QACCT IDX index number 
>QACCT DUMP with entries or datafilled only 
>QACCT LIST index number 
>QACCT COPY from index to index 
>QACCT DELETE index number with entries prompt 
>QACCT FIND account code digits 
Parameters 
Command parameters are described in Table 1-46. 
Table 1-46 
QACCT parameter descriptions 
Subcommand Parameter Values Description 
HELP topic Valid values include: Displays additional information on 
< IDX specified command function (topic) 
and its parameters. 
e DUMP 
e LIST 
e COPY 
e DELETE 
e FIND 
e AUDIT 
—continued— 
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QACCT (continued) 


Table 1-46 
QACCT parameter descriptions (continued) 


Subcommand Parameter Values 


IDX index number 0 to 99999 


DUMP 


e Y 


e N 
(default) 


with entries Valid values include: 


Description 


Displays the following information: 


e number of account code 
database index 


e length of all account codes 
in the index 


e total number of account codes 


Displays the following information: 


e number of every index in the 
table 


e length of all account codes in 
each index 


e length of all account codes in 
each index 


e number of account codes in 
each index 


Note: Display is modified depending 
on selection of “with entries” or 
“datafill only” parameters. 


Expands DUMP display to include 
the index information that the LIST 
function generates; this includes the 
account code information. 


Limits DUMP display to include only 
the index information the IDX 
parameter generates. 


—continued— 
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QACCT (continued) 
Table 1-46 
QACCT parameter descriptions (continued) 
Subcommand Parameter Values Description 
datafill only Valid values include: 
e Y Shortens the DUMP display to 
include only indexes with datafill. 
e N Expands the DUMP display to 
(default) include every index. 
LIST index number 0 to 99999 Displays following information: 
e number of index 
e length of all account codes in the 
index 
e total number of account codes 
* account code entries 
COPY Copies account code information 
from one index to another empty 
index. 
from index 0 to 99999 Specifies the index number that 
contains information to be copied. 
to index 0 to 99999 Empties the index number that 
contains copied information. 
DELETE Index number 0 to 99999 Removes account code entries from 


with entries 


Valid values include: 
e Y 


a single index. 


Note: DELETE is modified 
depending on selection of “with 
entries” or “prompt” parameters. 


Displays index to be deleted and the 
index information generated by LIST 
(including account code entries). 


—continued— 
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QACCT (continued) 


Table 1-46 
QACCT parameter descriptions (continued) 


Subcommand Parameter Values 


e N 
(default) 


prompt Valid values include: 


e Y 
(default) 


e N 


FIND account code 1 to 12 digits 
digits 


AUDIT 


Description 


Displays only the following index 
information generated by the IDX 
parameter: 


e index number 
e length of account codes 
e number of account codes 


Note: The “with entries” parameters 
control the display contents only; use 
the DELETE command and an index 
number to remove all information. 


User must respond to confirmation 
prompt before removal of an index. 


No confirmation prompt is displayed 
before deletion. 


Finds account code digit entries that 
either fully or partially match the 
value entered into the “account code 
digits” parameter. 


Removes all ACSCRN2 indexes 
without account code entries. 


—end— 


Example command 
>QACCT IDX 


Responses 


The following are examples of responses to QACCT commands: 


QACCT IDX 
>QACCT IDX 10 


Account Code Database Index: 10 
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Account Code Length: 4 
Number of Acct Codes: 5 


QACCT DUMP 
>QACCT DUMP 
Account Code Database Index: 0 
Account Code Length: 5 
Number of Acct Codes: 1 


Account Code Database Index: 1 
Account Code Length: 2 
Number of Acct Codes: 1 


Account Code Database Index: 2 
Account Code Length: 5 
Number of Acct Codes: 1 


Account Code Database Index: 3 
Account Code Length: 3 
Number of Acct Codes: 1 


Account Code Database Index: 4 
Account Code Length: 12 
Number of Acct Codes: 1 


Account Code Database Index: 5 
The index is empty. 


QACCT LIST 
>QACCT LIST 10 
Account Code Database Index: 10 
Account Code Length: 4 
Number of Acct Codes: 5 
Entry: 1707 
Entry: 5511 
Entry: 5522 
Entry: 7093 
Entry: 8434 


QACCT COPY 
>QACCT COPY 67 


Copying: 
From Database Index: 6 
To Database Index: 7 
Done. 


QACCT DELETE 
>QACCT DELETE 7 
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QACCT (end) 


Account Code Database Index: 7 

Account Code Length: 7 

Number of Acct Codes: 1 

You are DELETING this index from the database. 


Please confirm (“YES”, “Y”; “NO”, or “N”): 

>Y 

Index deleted. 

QACCT FIND 

>QACCT FIND 55 

Searching database for digit match . 
Index: 6 Matched Account code Digits: 5545678 
Index: 8 Matched Account code Digits: 5511 
Index: 10 Matched Account code Digits: 5511 


Matched Account code Digits: 5522 
Index 3343 Matched Account code Digits: 5511 


QACCT AUDIT 
>QACCT AUDIT 


Starting Audit Scan... 
Cleaning up Index: 0 
Finished Audit. 


Error messages 


The following error messages may display as a result of the QACCT 
command: 


Table ACSCRN2 is being written to by another process. Try 
again. 


Explanation: 

A QACCT command is trying to update table ACSCRN2 while 
another process is already changing the table. (Multiple processes 
can read the table at the same time.) 


User action: 
Try the command again. 


Related commands 
None 
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Purpose 


The QANI command enhances your ability to manipulate the indexes and 
display the information in tables ANIVAL, MULTPROF, and UNIPROF. 
QANI is a maintenance tool for tables ANIVAL, MULTPROF, and 
UNIPROF. 


The QANI command provides the following commands shown in Table 


1-47. 


Table 1-47 
QANI command functions 


Function Description 


Help Displays a description of one of the QANI 
tool's commands and its parameters. 


Copy Copies an entry in ANIVAL, MULTPROF 
or UNIPROF from one specified entry to 
a different, unallocated specified entry. 


Count Displays the total number of entries 
contained within the ANIVAL, 
MULTPROF or UNIPROF table. 


Display Displays a single profile ANI from the 
UNIPROF table. Displays a multiple 
profile ANI from the MULTPROF table, 
followed by all corresponding profiles 
from the UNIPROF table. 


Disprof Displays a single profile ANI from the 
UNIPROF table. Displays a multiple 
profile ANI from the MULTPROF table, 
and displays the chosen profile from 
table UNIPROF. The chosen profile 
displayed from the UNIPROF table is 
based on the given ANI, CIC, Dialed 
Number, and an optional NOA. 


Dump Displays all the tuples contained between 
a range of entries in either table ANIVAL, 
MULTPROF or UNIPROF. 
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Function Description 


Find Displays all the entries in the ANIVAL, 
UNIPROF or MULTPROF table that 
match a single specified criteria. 


List Displays the stored information for a 
specified entry in the ANIVAL, UNIPROF 
or MULTPROF table. 

Delete Deletes the specified entry from ANIVAL, 


UNIPROF or MULTPROF table. 


Rename Allows a specified key entry in table 
UNIPROF or table MULTPROF to be 
renamed, and updates the associated 
ANIVAL tuples that reference the renamed 
MULTPROF or UNIPROF tuple. 


Quit Leaves the QANI environment and 
returns to Cl. 


Restrictions 
Restrictions associated with the QANI command include the following: 
e During an ANIMOVE conversion, you cannot make additions and 
changes to the QANI tables ANIVAL, UNIPROF, or MULTPROF. 
e Although you cannot update the QANI tables during an ANIMOVE 
conversion, you can read and display them at any time. 
Access 
>QANI 
Syntax 
The syntax for the QANI command is as follows: 
>QANI 
Parameters 


The parameters of the QANI command’s various functions are described in 
Table 1-48 through Table 1-57: 
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Table 1-48 
Help function parameter descriptions 


Parameter Values Description 
Topic Copy, Count, Identifies the QANI function for which the 
Display, Dump, | command displays instructional 
Find, List, information. 
Delete, 
Rename, 
Disprof, Quit 
—end— 
Table 1-49 
Copy function parameter descriptions 
Parameter Values Description 
Table Anival, Uniprof, Multiple ANI Database tables. 
Multprof 
From Entry Valid table The entry from which the command 
entry copies information. 
To Entry Unallocated The empty entry into which the command 
table entry places the copied information. 
—end— 
Table 1-50 


Count function parameter descriptions 


Parameter Values Description 
Table Anival, Uniprof, Multiple ANI Database tables. 
Multprof 
—end— 
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Table 1-51 
Display function parameter descriptions 
Parameter Values Description 
ANI 3,6, or 10 Digit Valid ANI from table ANIVAL. 
ANI 
—end— 
Table 1-52 
Disprof function parameter descriptions 
Parameter Values Description 
ANI 3,6, or 10 Digit Valid ANI from table ANIVAL. 
ANI 
CIC 0000-9999 Valid Carrier Identification Code. 
Dialed Number 10-Digit ANI Valid 10-digit ANI from table ANIVAL. 
0 0- 
0 and 10-Digit 0+ 
011 and International 
10-Digit 
NOA {0 to 127} Valid Nature of Address 
—end— 
Table 1-53 
Dump function parameter descriptions 
Parameter Values Description 
Table Anival, Uniprof, Multiple ANI Database tables. 
Multprof 
From Entry Valid table The entry from which the command 
entry displays information. 
—end— 
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Table 1-53 
Dump function parameter descriptions (continued) 


Parameter Values Description 
To Entry Valid table The entry for which the command displays 
entry information. 
—end— 
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Table 1-54 


Find function parameter descriptions 


Parameter 


Values 


Description 


Field 


Value 


Profnum, 
Unitype, 
Status, Opart, 
Tpart, Satres, 
Mltcosid, 
Anidelv, 
Acctidx, 
Acctlen, 
Acctval, Pinlen, 
Pinindex, 
Pindigs, 
Opchoice, 
Passthru, 
Caingrp, 
Cdrtmplt, 
Billact, 
Useedit, 
Aniprof, 
Multprof, 

All 


Valid Uniprof 
and Multprof 
key for field 
Aniprof. 

Valid Uniprof 
profile for all 
the other fields. 


Search criteria values. 


Depends on the search criteria chosen. 


—end— 
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Table 1-55 


List function parameter descriptions 


Parameter Values Description 
Table Anival, Uniprof, Multiple ANI Database tables. 
Multprof 
Entry Valid table The entry for which the command displays 
entry information. 
—end— 
Table 1-56 


Delete function parameter descriptions 


Parameter Values Description 
Table Anival, Uniprof, Multiple ANI Database tables. 
Multprof 
Entry Valid table The entry for which the command displays 
entry information. 
—end— 
Table 1-57 


Rename function parameter descriptions 


Parameter Values Description 
Table Uniprof, Multiple ANI Database profile tables. 
Multprof 
From Key Valid table key The specified key that needs to be 
renamed. 
To Key New key name The new key name. 
—end— 
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Example Commands/Responses 


The following are example commands and responses for the QANI 
command’s various functions. The datafill values used in the QANI 


examples are for illustration purposes only. 


Examples of QANI command variations 


Help 
Copy 
Count 
Display 
Dump 
Find 
List 
Delete 
Rename 


00077700 P 
COC UU OOD 


m O E o o es es m e a 


elp Disprof 

Copy Anival 2136112211 2146112211 
Copy Uniprof UNI1234 UNI4567 

Copy Multprof MULT678 MULT890 
Count Anival 


Count Uniprof 

Count Multprof 

Display 2566781234 

Display 456789 

Display 213 

Disprof 2145551234 222 8174727353 3 
Dump Anival 2142345678 2145455678 
Dump Uniprof UNI5678 UNI5900 
Dump Multprof MULT4576 MULT7899 
Find Profnum 56 

Find Unitype NPA 

Find Status CA 

Find Opart 111 

Find Tpart 0 

Find Satres Y 

Find Mltcosid 0 

Find Anidelv ALWAYS 

Find Acctidx 10 

Find Acctlen 5 

Find Acctval N 

Find Pinlen 2 

Find Pinindex 4444 

Find Pindigs 123 

Find Opchoice 125 

Find Passthru PURE_ONLY 

Find Caingrp ANIGRP 
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Find Cdrtmplt UCS06 
Find Useedit Y 
Find Billact Y 
Find Aniprof UNI234 

Find Multprof UNI234 

Find All SUB AL 7 31 N 0 ALWAYS CAINGRP OFFGRP ACCTIDX 0 $ 
List Anival 2146112211 

List Uniprof UNI123 

List Multprof MULT2345 

Delete Anival 2146112233 

Delete Uniprof UNI890 

Delete Multprof MULT44 

Rename Uniprof UNI67895 UNI12345 

Rename Multprof MULT1234 MULT4567 

Quit 


Example when using the Help function 


This command displays a description for one of the QANI command’s 
functions: Help, Copy, Count, Display, Dump, Find, List, Delete, Rename, 
and Disprof. 


> Help <Topic> 


Responses for the Help function 


A query for help information on the Help function, Help Help, obtains the 
following response: 


Command: Help 


The Help command displays a description of any QANI command and its 
parameters. 


{Help <Topic> {Help, Copy, Count, Display, Dump, Find, List, Delete, 
Rename, Disprof, Quit} 


A query for help information on the Copy command, Help Copy, obtains the 
following response: : 


Command: Copy 


The Copy command copies a tuple from one entry to a different, 
unallocated entry. The entry that is copied must contain data, and 
the destination entry must be empty. 


Copy <Table> {Anival, Uniprof, Multprof} <From Entry> <To Entry> 
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A query for help information on the Count command, Help count, obtains 
the following response: 


Command: Count 


The Count command displays the total number of tuples contained in 
either table ANIVAL, UNIPROF, or MULTPROF. The table name is 
specified by the user on the command line. 


Count <Table> {Anival, Uniprof, Multprof} 


A query for help information on the Display command, Help Display, 
obtains the following response: 


Command: Display 


The Display command displays a profile from the UNIPROF table for 
ANIs with a profile type of UNI (3-, 6-, or 10 digits). The command 
displays a profile from the MULTPROF table for ANIs with profile 
type MULT (10 digits). 


Display <ANI> {3-, 6-, or 10 digit ANT} 


A query for help information on the Dump command, Help Dump, obtains 
the following response: 


Command: Dump 


The Dump command displays all the tuples contained between a range 
of entries from either the ANIVAL, MULTPROF or UNIPROF tables. 


Dump <Table> {Anival, Uniprof, Multprof} <From Entry> <To Entry> 


A query for help information on the Find command, Help Find, obtains the 
following response: 


Command: Find 


The Find command compares every entry in the table ANIVAL, UNIPROF 
or MULTPROF until it finds a match of the search criteria field 
entered by the user on the command line. 


Find <Field> {Profnum, Unitype, Status, Opart, Tpart, Satres, 
Mitcosid, Anidelv, Acctidx, Acctlen, Acctval, Pinlen, 
Pinindex, Pindigs, Opchoice, Passthru, Caingrp, 
Cdrtmplt, Useedit, Billact, Aniprof, Multprof, All} 
<Value> 
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A query for help information on the List command, Help List, obtains the 
following response: 


Command: List 


The List command displays the tuple information on a single entry 
that is specified by the user on the command line. 


List <Table> {Anival, Uniprof, Multprof} <Entry> 


A query for help information on the Delete command, Help Delete, obtains 
the following response: 


Command: Delete 


The Delete command removes the entry specified on the command line 
from table ANIVAL, MULTPROF or UNIPROF. 


Delete <Table> {Anival, Uniprof, Multprof} <Entry> 


A query for help information on the Rename command, Help Rename, 
obtains the following response: 


Command: Rename 


The Rename command renames the key specified on the command line 
from table MULTPROF or UNIPROF to the new key name specified, and 
updates the associated ANIVAL tuples that reference the renamed MULTPROF or UNIPROF 
tuples. 


Rename <Table> {Uniprof, Multprof} <From Key> <To Key> 


A query for help information on the Disprof command, Help Disprof, 
obtains the following response: 


Command: DISPROF 


The DISPROF command displays the profile to be chosen given an ANI, 
CIC, dialed number and, optionally, an NOA. The NOA is only 
necessary for international jurisdiction determination. For an ANI 
with profile type UNI (3-, 6-, or 10 digits), the profile from table 
UNIPROF is displayed. For a Multiple profile ANI, the profile from 
table MULTPROF is displayed followed by the profile from table 
UNIPROF. A warning message is displayed if a profile is not found. 


DISPROF <ANI> {3-, 6-, or 10 digit ANI} <CIC> <dialed number> [NOA] 


A query for help information on the Quit command, Help Quit, obtains 
the following response: 
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Exampl 


Command: Quit 
The Quit command exits the QANI CI supercom. 
Quit 


System action 
None. 


User action: 
The Help function does not require user action other than entering 
correct syntax at the command line. 


e when using the Copy function 


The Copy function copies a tuple from one entry to a different, unallocated 
entry. The entry that is copied must contain data, and the destination must be 
empty. 


This section provides possible responses for four example uses of the QANI 
command’s Copy function. 


>Copy <Table> {Anival, Uniprof, Multprof} <From Entry> <To Entry> 


Responses for the Copy function 


An example of a successful Copy function, copy Anival 7169506666 
7169506667, Obtains the following response: 


Copying: 
From Database Entry: 7169506666 
To Database Entry: 7169506667 
Done. 


An example of a Copy command with a target entry that contains datafill, 
Copy UNIPROF UNI828 UNI829, Obtains the following response: 


The TO entry must be empty. 


An example of a Copy command with a source entry with no datafill, copy 
Multprof MULT1234 MULT2345, Obtains the following response: 


The FROM entry must be datafilled. 


An example of a Copy command with a source entry with no datafill, copy 
Multprof MULTONE MULT2345, obtains the following response: 
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The FROM entry must be datafilled. 


An example of a Copy command that is executed while an ANIMOVE 
conversion is in process, Anival 7169506666 7169506667, Obtains the 
following response: 


An ANIMOVE conversion is in process. 


Updates to tables ANISCUSP, ANIVAL, and UNIPROF are not allowed 
during the conversion. 


System action: 
A successful Copy function increases the tuples in tables ANIVAL, 
UNIPROF, or MULTPROF. 


User action: 
The Copy command does not require user action other than entering 
correct syntax at the command line. 


Example when using the Count function 


The Count command displays the total number of tuples contained in table 
ANIVAL, MULTPROF, or UNIPROF. 


This section provides possible responses for three example uses of the QANI 
command’s Count function. 


>Count <Table> {Anival, Uniprof, Multprof} 


Responses for the Count function 


An example of a Count command on table ANIVAL, count Anival, obtains 
the following response: 


Counting: 
Table ANIVAL contains 956 entries. 


An example of a Count command on table UNIPROF, count uniprof, 
obtains the following response: 


Counting: 
Table UNIPROF contains 828 entries. 


An example of a Count command on table MULTPROF, count Multprof, 


Counting: 
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Table MULTPROF contains 567 entries. 


System action: 
None. 


User action: 
The Count command does not require user action other than entering 
correct syntax at the command line. 


Example when using the Display function 


This section provides possible responses for example uses of the QANI 
command’s Display function. The response displays the profile and its 
datafill for the specified ANI. 


>Display <ANI> {3, 6 or 10 digit ANI} 


Responses for the Display function 


An example Display command for a single profile ANI, Display 
2143331234, obtains the following response: 


Key: UNIPROF2 


Profnum: i 
Unitype: SUB 
Status: CA 
Opart: 339 
Termpart: 0 
Satres: N 
Mltcosid: 0 
Anidelv: CGNONLY 


An example Display command for a multiple profile ANI, Display 
2145551234, Obtains the following response: 


Key: MULTPROF3 


Option: CICJUR 

CIC: 221 

Jurisdiction: INTER 

Uniprofidx: UNIPROF2 
Key: UNIPROF2 


Profnum: 2 
Unitype: SUB 
Status: AL 
Opart: 31 
Termpart: 7 
Satres: N 


297-2621-819 Standard 14.01 April 2002 


Commands 1-207 


Cl commands 
QANI (continued) 


Mitcosid: 0 


Anidelv: ALWAYS 
Opchoice Index: 2 
Account Index: 1 


Jurisdiction: INTRA 
Uniprofidx: UNIPROF3 
Key: UNIPROF3 


Profnum: 3 
Unitype: SUB 
Status: AL 
Opart: 31 
Termpart: 7 
Satres: N 
Mitcosid: 0 
Anidelv: ALWAYS 


Jurisdiction: INTL 
Uniprofidx: UNIPROF9 
Key: UNIPROF9 


Profnum: 9 
Unitype: SUB 
Status: AL 
Opart: 31 
Termpart: 7 
Satres: N 
Mitcosid: 0 
Anidelv: NEVER 


Jurisdiction: DEFJUR 
Uniprofidx: UNIPROF4 
Key: UNIPROF4 


Profnum: 4 
Unitype: SUB 
Status: AL 
Opart: 31 
Termpart: 7 
Satres: N 
Mitcosid: 0 
Anidelv: NEVER 
Account Index: 1 


Option: CICJUR 

CIC: 223 

Jurisdiction: INTRA 

Uniprofidx: UNIPROF3 
Key: UNIPROF3 


Profnum: 3 
Unitype: SUB 
Status: AL 
Opart: 31 
Termpart: 7 
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Satres: N 
Mitcosid: 0 


Anidelv: NEVER 


Option: CICJUR 
Cre: 225 
Jurisdiction: INTL 


Uniprofidx: UNIPROF9 


Key: UNIPROF9 


Profnum: 9 
Unitype: SUB 
Status: AL 
Opart: 31 
Termpart: 7 
Satres: N 


Mitcosid: 0 


Anidelv: NEVER 


Account Index: 


1 


Jurisdiction: DEFJUR 
Uniprofidx: UNIPROF6 


Key: UNIPROF6 


Profnum: 6 
Unitype: SUB 
Status: CA 
Opart: 31 
Termpart: 7 
Satres: N 


Mltcosid: 0 


Anidelv: NEVER 


Account Index: 


Option: CIC 
Cres: 229 


1 


Uniprofidx: UNIPROF2 


Key: UNIPROF2 


Profnum: 2 
Unitype: SUB 
Status: AL 
Opart: 31 
Termpart: 7 
Satres: N 


Mitcosid: 0 


Anidelv: ALWAYS 


Account Index: 
Opchoice Index 


Option: DEFAULT 


1 
¿2 


Uniprofidx: UNIPROF6 


Key: UNIPROF6 
Profnum: 6 
Unitype: SUB 
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Status: 
Opart: 
Termpart: 
Satres: 
Mitcosid: 
Anidelv: 


ALWAYS 


An example Display command for a multiple profile ANI, Display 
6136210045, obtains the following response: 


Key: MULTONE 


Option: CIC 

CIC: 1234 

Uniprofidx: 1 

Key: 1 

Unitype: 
Status: 
Opart: 
Termpart: 
Satres: 
Mltcosid: 
Anidelv: 


Option: JUR 

Jurisdiction: 

Uniprofidx: 5 

Key: 5 

Profnum: 
Unitype: 
Status: 
Opart: 
Termpart: 
Satres: 
Mitcosid: 
Anidelv: 


Jurisdiction: 
Uniprofidx: 4 
Key: 4 

Profnum: 
Unitype: 
Status: 
Opart: 
Termpart: 
Satres: 
Mitcosid: 
Anidelv: 


An example of a Display command for an empty index, Display 909, 


ALWAYS 


INTER 


ALWAYS 
INTRA 


ALWAYS 


obtains the following response: 
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ANIVAL ANI: 909 
The ANI is not present. 


System action: 
None. 


User action: 
The Display command does not require user action other than 
entering correct syntax at the command line. 


Example when using the Dump function 


The Dump command displays all the tuples contained between a range of 
entries from either the ANIVAL, MULTPROF, or UNIPROF tables. Since 
tables UNIPROF and MULTPROF are unsorted, the Dump command does 
not display tuples in consecutive order. 


This section provides possible responses for example uses of the QANI 
command’s Dump function. 


>Dump <Table> {Anival, Multprof, Uniprof} <From Entry> <To Entry> 


Responses for the Dump function 


An example of a successful Dump command on table ANIVAL, Dump anival 
2146112211 2146112219, obtains the following response: 


KEY TYPE PROFILE 
2146112211 UNI UNI 620 
2146112212 UNI UNI621 
2146112213 UNI UNI 622 
2146112214 UNI UNI 623 
2146112215 UNI UNI 624 
2146112216 UNI UNI625 
2146112217 UNI UNI 626 
2146112218 UNI UNI 627 
2146112219 UNI UNI 628 
Total Tuples Found: 9 


An example of a successful Dump command on table UNIPROF, pump 
Uniprof UNI210 UNI211, obtains the following response: 


KEY PROFNUM UNITYPE STATUS OPART TPART SATRES MLTCOSID ANIDELV OPTIONS 
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UNI210 210 SUB 111 0 N 0 ALWAYS 
UNI218 218 SUB 111 0 N 0 ALWAYS 


An example of a successful Dump command on table MULTPROF, Dump 
Multprof MULT1 MULT2, Obtains the following response: 


KEY OPTIONS 


MULT1 (CIC 123 UNI1) (CIC 2345 UNI210) 
MULT2 (CIC 8888 UNI634) (CIC 345 UNI535) (DEFAULT UNI628) 


An example of a Dump command with a target entry with no datafill, pump 
Uniprof UNI823 UNI1000, obtains the following response: 


The TO entry must be datafilled. 


An example of a Dump command with a source entry with no datafill, pump 
Multprof MULT1 MULT943, obtains the following response: 


The FROM entry must be datafilled. 


An example of the Dump command for an invalid target range, Dump Anival 
2145551234, obtains the following response: 


Invalid range specified. 


System action: 
None. 


User action: 
The Dump function does not require user action other than entering 
correct syntax at the command line. 


Example when using the Find function 


The Find command compares every entry in table ANIVAL or UNIPROF to 
the one entered by the user on the command line. It then displays the entry in 
the table that matches the one entered by the user. 


This section provides possible responses for example uses of the QANI 
command’s Find function. 
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>Find <Field> {Profnum, Unitype, Status, Opart, Tpart, Satres, Mltcosid, 
Anidelv, Acctidx, Acctlen, Acctval, Pinlen, Pinindex, Pindigs, 
Opchoice, Passthru, Caingrp, Cdrtmplt, Billact, Useedit, 


Aniprof, Multprof, All} <Value> 


Responses for the Find function 


An example of a Find command, Find unitype nea, obtains the following 


response: 


Searching database for match ... 


KEY PROFNUM UNITYPE STATUS OPART TPART SATR 


ES MLTCOSID ANIDELV OPTIONS 


UNI210 210 NPA CA 


Total Tuples Found: 1 
Search finished. 


An example of a Find command, Find Aniprof unI1, obtains the following 


response: 


Searching database for match . 


KEY TYPE PROFILE 


2146112211 UNI UNI1 


Total Tuples Found: 1 
Search finished. 


An example of a Find command for which it does not find a match, Fina 
Profnum 5678, Obtains the following response: 


Searching database for match ... 


No match found. 
Search finished. 


System action: 
None. 


User action: 


The Find function does not require user action other than entering 
correct syntax at the command line. 
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Example when using the List function 


The List command displays the tuple information on a single entry that is 
specified by the user on the command line. 


This section provides possible responses for example uses of the QANI 
command’s List function. 


>List <Table> {Anival, Multprof, Uniprof} <Entry> 


Responses for the List function 


An example of a List command on table ANIVAL, List ANIVAL 
2146112211, obtains the following response: 


Listing: 
KEY TYPE PROFILE 
2146112211 UNI UNI1 


Total Tuples Found: 1 
Done. 


An example of a List command on table UNIPROF, List uniprof UNI210, 
obtains the following response: 


Listing: 
KEY PROFNUM UNITYPE STATUS OPART TPART SATRES MLTCOSID ANIDELV OPTIONS 


UNI210 210 SUB 111 0 N 0 ALWAYS 


Total Tuples Found: 1 
Done. 


An example of a List command on table MULTPROF, List muitprof 
MULTONE, Obtains the following response: 


Listing: 
KEY OPTIONS 


MULTONE (CIC 1234 1) (CIC 2222 1) (JUR (INTER 5) (INTRA 4)) (DEFAULT 6) 


Total Tuples Found: 1 
Done. 


Digital Switching Systems UCS DMS-250 Commands Reference Manual UCS17 


1-214 Commands 


Cl commands 
QANI (continued) 


An example of a List command that does not find an entry, Find ANIVAL 
2345671234, obtains the following response: 


Listing: 
The entry you are attempting to list does not exist. 


Done. 


System action: 
None. 


User action: 


The List function does not require user action other than entering 
correct syntax at the command line. 


Example when using the Delete function 


The Delete command removes the entry specified on the command line from 
table ANIVAL, MULTPROF, or UNIPROF. 


This section provides possible responses for example uses of the QANI 
command’s Delete function. 


>Delete <Table> {Anival, Uniprof, Multprof} <Entry> 


Responses for the Delete function 


An example of a Delete command on table ANIVAL, Delete Anival 
2145671234, obtains the following response: 


Entry: 2145671234 


You are DELETING this entry from the database. 
Please confirm (“YES”, “Y”; “NO”, or “N”): 

>y 

Entry deleted. 


An example of a Delete command on table UNIPROF, Delete Uniprof 
UNI234, obtains the following response: 


Entry: UNI234 


You are DELETING this entry from the database. 
Please confirm (“YES”, “YY”; “NO”, or “N”): 
>y 
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Entry deleted. 


An example of a Delete command on table MULTPROF, Delete Multprof 
MULT214, obtains the following response: 


Entry: MULT214 


You are DELETING this entry from the database. 
Please confirm (“YES”, “Y”, “NO”, or “N”): 

>y 

Entry deleted. 


An example of a Delete command for a nonexistent entry in table 
UNIPROF, Delete UNIPROF MULT555, Obtains the following response: 


No matching entries found. 


An example of a Delete command that is executed while an ANIMOVE 
conversion is in process, Delete Anival 2145671234, Obtains the following 
response: 


An ANIMOVE conversion is in process. 


Updates to tables ANISCUSP, ANIVAL, and UNIPROF are not allowed 
during the conversion. 


System action: 
A succesful Delete command decreases the tuples in table ANIVAL, 
UNIPROF or MULTPROF. 


User action: 
The user must confirm the removal of the entry from the database. 


Example when using the Rename function 


The Rename command renames the specified key name to a different key 
name, and updates the associated ANIVAL tuples that reference the renamed 
UNIPROF or MULTPROF tables. 


This section provides possible responses for three example uses of the QANI 
command’s Rename function. 


>Rename <Table> {Uniprof, Multprof} <From Key><To Key> 
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Responses for the Rename function 


An example of a successful Rename command, Rename MULTPROF MULT234 
MULT5678, Obtains the following response: 


Renaming: 
From Key: MULT234 
To Key: MULT5678 
Done. 


An example of a Rename command with a target key name that already 
exists, Rename UNIPROF UNI828 UNI829, Obtains the following response: 


The TO key already exists. 


An example of a Rename command with a source key that does not exist, 
Rename Multprof MULT1234 MULT2345, Obtains the following response: 


The FROM key must be datafilled. 


An example of a Rename command that is executed while an ANIMOVE 
conversion is in process, Rename MULTPROF MULT234 MULT5678, Obtains the 
following response: 


An ANIMOVE conversion is in process. 


Updates to tables ANISCUSP, ANIVAL, and UNIPROF are not allowed 
during the conversion. 


System action: 
None. 


User action: 
The Rename function does not require user action other than entering 
correct syntax at the command line. 


Example when using the Disprof function 


The Disprof command determines jurisdiction and displays the ANI profile 
from table MULTPROF or UNIPROF. This command functions for a 
specified ANI, CIC, dialed number, and an optional NOA. 


This section provides possible responses for use of the QANI command’s 
Disprof function. 


>Disprof <ANI> <CIC> <Dialed Number> [NOA] 
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Responses for the Disprof function 
An example Disprof command for a single profile ANI (i.e. proftype field in 


ANIVAL is UND, Disprof 2144441234 0221 2149991234, obtains the 
following response: 


Key: UNIPROF2 


Profnum: 2 
Unitype: SUB 
Status: AL 
Opart: 31 
Termpart: 7 
Satres: N 
Mltcosid: 0 
Anidelv: ALWAYS 
Opchoice Index: 2 
Account Index: 1 


An example Disprof command for a multiple profile ANI (i.e. proftype field 
in ANIVAL is MULTONEB), Disprof 6136210045 2222 6136210048, 
obtains the following response: 


Key: MULTONE 
Option: JUR 
Jurisdiction: INTRA 
Uniprofidx: 2 


Key: 2 

Profnum: 2 
Unitype: SUB 
Status: AL 
Opart: 2 
Termpart: 2 
Satres: N 
Mitcosid: 0 
Anidelv: ALWAYS 
Account Index: 1 


An example Disprof command for a multiple profile ANI (i.e. proftype field 
in ANIVAL is MULT) with an international jurisdiction, Disprof 
2145551234 0222 6725551234 4, obtains the following response: 


Key: MULTPROF3 

Option: CICJUR 

CIC: 222 

Jurisdiction: INTL 

Uniprofidx: UNIPROF9 
Key: UNIPROF9 
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QANI (end) 
Profnum: 9 
Unitype: SUB 
Status: AL 
Opart: 31 
Termpart: 7 
Satres: N 
Mitcosid: 0 
Anidelv: NEVER 
Account Index: T 


An example Disprof command for an ANI without a profile, Disprof 
21488812 0001 6725551234, obtains the following response: 


WARNING: This call will receive ADBF treatment. A profile for 
this ANI could not be determined. Possible causes are: ANI 
not found in table ANIVAL or DEFAULT profile, DEFJUR profile 
or EVAL63 option not datafilled in table MULTPROF for this 
ANI. 


Related commands 
None 


Release history 


The subcommands DISPLAY, DISPROF, COPY, FIND, and LIST are 
modified to support the new JUR functionality (A59033229). 
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Purpose 


The Travel Card Number Test (TCNTEST) command verifies the integrity 
of the travel card number (TCN) subsystem by validating calling card 
numbers located at remote database location(s). 


Restrictions 
Restrictions associated with the TCNTEST include: 


e Each of the TCN subsystems must be in service. 
e Remote database must be operational. 


e The number of simultaneous users for the TCNTEST command is 
limited to the number of users specified by office parameter 
TESTSS_MAX_USERS (table OFC VAR). 


e Datafill must be located in the following tables: 

— C7GTT 

— C7GTTYPE 

— C7LKSET 

— C7LINK 

— C7LOCSSN 

— C7NETWRK 

— C7RTESET 


Access 
Accessible from any MAP level. 


Syntax 
>TCNTEST tcn_number timeout 


Parameters 
Command parameters are described in Table 1-58. 
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TCNTEST (continued) 
Table 1-58 
TCNTEST parameter descriptions 
Parameter Values Description 
tcn_number 0to9 Specifies calling card number. 
Number restrictions include: 
e maximum length = 14 digits 
e first digit = 2 to 9 
e remaining digits = 0 to 9 
Note: The first digit of a calling card number may not 
be a “0” or “1”. 
timeout 0 to 30 Specifies wait time (in seconds) to wait for a reply 
(optional back from the SCP. 
parameter) 
Note: |f a value is not specified, the system uses the 
default value defined in 
TCN_DCP_RESPONSE_TIMEOUT (table OFCVAR). 
—end— 


Example command 


>TCNTEST 8999289289289899 5 
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Responses 


After the TCNTEST command successfully completes, the system displays 
the following response: 


Time for sending query and receiving response is: x 
minutes, x seconds, x milliseconds. 

The following data was returned from the RDB. 

The CCN number xxxxxxxxxx is valid 


Trap class: x 
Originating partition: XXX 
Terminating partition: XX 
Satellite restriction: XX 

Account code validation required: xx 
COS index: x 

Trap: XX 

Explanation: 


The system displays the time required to send and receive the query. 
Information on whether the CCN is valid, along with other 
information, is also included. 


User action: 
None 


Error messages 


The following error messages may display as a result of the TCNTEST 
command. 


66,99 


Note: The system supplies the values represented by “x”. 


A reject message is received from the RDB. 


Explanation: 
The remote database rejected the query from the UCS DMS-250 
switch. 


User action: 
Correct query values. 
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An error message is received from the RDB. 


Explanation: 
The remote database could not generate a response due to a transient 
error. 


User action: 
Correct response values. 


An error is recognized in the TCAP decoding facilities. 


Explanation: 
The remote database response message violated TCAP syntax. The 
response message is rejected. 


User action: 
Correct TCAP syntax. 


Bad parameter in the message. 
Explanation: 
A bad parameter exists in the TCAP message. 


User action: 
Correct TCAP values. 


Either the CCN is invalid or it does not exist in the RDB. 
Explanation: 
The remote database did not recognize the CCN in the query. 


User action: 
Verify the calling card number is valid. 


Encoder failed to assemble the query. 
Explanation: 
The query is aborted. This is an unexpected situation. 


User action: 
Try the query again. 
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Failed to wait in order to receive a message. Mailbox failure 
code is = xx.Failed to wait in order to receive a message. 
Mailbox failure code is = xx. 


Explanation: 
The system failed to wait for the response message. This is an 
unexpected situation. 


User action: 
Save the software error report for resolution of the problem. 


Invalid digits in CCN parameter. 


Explanation: 
The acceptable digits are numeric digits only (0—9). Any other 
characters are rejected. 


User action: 
Correct the calling card number digits entered. 


No response within assigned timeout value 
Timeout value is: x seconds 


Explanation: 
The timeout value assigned in the command has expired. 


System action: 
The system aborted the query. 


Number of parameters in the response message is incorrect. 


Explanation: 

The UCS DMS-250 switch received a response message from the 
remote database, but it did not have the correct number of TCAP 
parameters. The response message is rejected. 


User action: 
Correct TCAP parameters. 
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Private parameter of the response msg had wrong length. 


Explanation: 

The UCS DMS-250 switch received a response message from the 
remote database, but the length of the response was incorrect. The 
response message is rejected. 


User action: 
Correct response length values. 


Query could not be sent to the RDB. 


Explanation: 
The query is aborted. 


User action: 
Try the query again and save the software error report for resolution 
of the problem. 


The component is not a national TCAP type. 


Explanation: 
The component of the received message is not coded as a national 
type. The message is rejected. 


User action: 
Correct TCAP code values. 


The component is not recognized. 


Explanation: 

The following response messages are valid for CCN validation: 
RETURN RESULT, REJECT, and ERROR. Any other type of 
response received for the calling card number is invalid. 


User action: 
Correct response values. 


The TCN application subsystem does not exist. 


Explanation: 
The TCAP software does not support the TCN application 
subsystem. 


User action: 
Check with switch administration for the proper software load. 
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The TCN application subsystem is out of service. 


Explanation: 
The TCN subsystem is currently out of service. It must be in service 
before a query goes through. 


User action: 
Return the subsystem to service (RTS). 


The parameter is not a private TCAP type. 


Explanation: 
The parameter group of the received message is not coded as a 
private TCAP parameter. A private parameter is expected. 


User action: 
Enter a private parameter. 


The query could not be sent to the RDB. It is bounced back to 
us by lower level of CCS7. 


Explanation: 
The system constructed the query, but it was returned to the UCS 
DMS-250 switch instead of being sent to the remote database. 


User action: 
Verify the MTP linksets and routesets are in service. 


The TCAP decoder failed to decode the response message. 
Packaging information is incorrect. 


Explanation: 
The TCAP coder failed to decode the received message. 


User action: 
Notify switch administration. 


Too many users are logged on to this TESTSS. 


Explanation: 
More people are using the TCNTEST command than defined in the 
office parameters. 


User action: 
Verify office parameter TESTSS250_MAX_USERS is sufficient. 
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Related commands 
Use the TESTSS command to verify the integrity of a subsystem. 
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Purpose 


Access 


Syntax 


The Translation Verification (TRAVER) tool simulates a call from a 
user-specified origination (such as a trunk) to a user-specified destination. 
The TRAVER tool allows the user to display the translations and routing 
associated with a particular call as a means to identify translations errors, 
oversights, or misdirections. 

TRAVER performs the following: 

e verifies the translation tables 

e aids in debugging and analyzing translation and routing datafill 


e helps determine reasons for the undesirable results and changes required 
to achieve the expected results 


Note: Unexpected results may include unexpected treatments or 
improper routing. 


TRAVER is capable of displaying the following information: 
e tables used to translate and route a call 


¢ call treatment 


TRAVER is accessible from any MAP level. 


Note: A default serving translations scheme (STS) value (range = 0 to 999) 
must be set with the Universal Traver Verification STS (UTVSTS) 
command before accessing TRAVER. In the following example, the STS 
value is 214: 


>UTVSTS 214 


A TRAVER command is made up of the following elements: 
e call originator code 

e originator identification 

e directory number or outgoing trunk identification 


e required report identification 
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The fixed parameters associated with TRAVER in the UCS DMS-250 
environment include: 


e TR—trunk originator 
>TRAVER TR clli [options] digits [options] trace [options] 


e R—route table originator 
>TRAVER R table [options] 


Parameters 


The TRAVER command has a complex syntax. Using the HELP command 
to display TRAVER command syntax produces a complete list of available 
required/optional parameters and subparameters. However, the use of 
individual parameters is customer- and switch-specific. 


CAUTION 

TRAVER coniains functionality that is not available. 
Some TRAVER command functionality visible on your 
screen is not available on your load. Please ignore it. 


Required parameters 
The following parameters are required for each origination type: 


e originator parameter and any required parameters 
e digits parameter and any required parameters 
e trace parameters and any required parameters 


Note: The digits and trace parameters are the same for all originations. 


Table 1-59 provides required parameter information for the Trunk Originator 
(TR) option. Table 1-63 provides required parameter information for the 
Route Table Originator (R) option. 
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Optional parameters 


Optional parameters may be required for originator, digits, or trace 
parameters. Additional information on TR optional parameters is located in 
the following tables: 


e Table 1-60—CLLI optional parameters 
e Table 1-61—Digits optional parameters 
e Table 1-62—Trace optional parameters 


Additional information on R optional parameters is located in the following 
table: 


e Table 1-64—Optional R parameters 


Table 1-59 
Required TR parameters 

Required Value Description Optional 

parameter parameter(s) 

TR — TR is entered when an incoming trunk is the originator. 
Optional parameters include common language location 
identifiers (CLLI), digits, and trace options. 

<CLLI> string CLLI = Common Language [<CLLIOPT> 

(16 alphanumeric Location Identifier CLLI Option 
characters) 


Note: The CLLI name mustbe  [<MBGOPTS> 
entered immediately after “TR”. | Multilocation Business 
Group Option 


[<TRIGOPT>] 
Trigger option 


Note: See Table 1-60 for 
additional information on 
optional CLLI parameters. 


Note: Required parameters are enclosed by < >. Optional parameters are enclosed by [ ]. Options 
within optional parameters are enclosed by { }. 


—continued— 
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Table 1-59 
Required TR parameters (continued) 
Required Value Description Optional 
parameter parameter(s) 
<DIGITS string digits = called party number [<CDNIE> 
ORN (0 to 30 Called Party Number 
FOR NO digits) N=no called party digits 
DIGITS> required [<NSF> 
N Network Specific Facilities 
(no digits Note: The called party digits 
required) are entered by the originator or = [<TNSIE> 


received by the originator ona Transit Network Selection 
incoming trunk. A value of ”N” 
in the “digits” field simulates [<OSAIE> 


trunk seizure. Operator System Access 


[<BC> 
Bearer Capability 


[<SR>] 
Services Requested 


[<Pl> 
ISUP Preference 
Indicator 


[<TRI> 
Transit Routing 
Information 


[<NETINFO 
Network Information 


[<FINFO> 
First In First Out 


[<RPOAP>] 


[<RPOAS>] 
Regional Private 
Operating Agency 


Note: Required parameters are enclosed by < >. Optional parameters are enclosed by [ ]. Options 
within optional parameters are enclosed by { }. 


—continued— 
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Table 1-59 
Required TR parameters (continued) 


Required Value Description 
parameter 


Optional 
parameter(s) 


[<NOA>] 
Nature of Address 


[<AINCHG>] 
Advanced Intelligent 
Network Information 
Change 


[<AIN_INFO>] 
Advanced Intelligent 
Network Information 


[<SCAIIN> 
SCAIIN Option 


Note: See Table 1-61 for 
additional information on 
optional DIGITS 
parameters. 


<TRACE> alphabetical trace = trace option 
string 


{<T>} 
Trace Option 


Trace displays the table(s) 
used to translate and route 
a call and the appropriate 
tuple for each table. 


Note: Required parameters are enclosed by < >. Optional parameters are enclosed by [ ]. Options 


within optional parameters are enclosed by { }. 


—continued— 
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Table 1-59 

Required TR parameters (continued) 
Required Value Description 
parameter 


Optional 
parameter(s) 


[<NT>] = No Trace Option 


No Trace displays digit 
translation routes, position 
routes, and the circuits 
and/or treatments on which 
the call would terminate. 


[<B>] = Both Option 


The Both Option displays 
the tables used in 
translation and the routes, 
treatments, and/or positions 
associated with the call. 


Note: See Table 1-61 for 
additional information on 
optional DIGITS 
parameters. 


within optional parameters are enclosed by { }. 


Note: Required parameters are enclosed by < >. Optional parameters are enclosed by [ ]. Options 


—end— 
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Table 1-60 
Optional TR parameters - CLLI 
Optional Additional 
parameter optional 
parameter/ 
response 


(if required) 


Additional 
optional 
parameter/ 
response 
(if required) 


Additional Additional 
optional optional 
parameter/ parameter/ 
response response 


(if required) (if required) 


[<CLLIOPT> {SAT 


CLLI option Satellite Data 
<bool>}] True} | 
satellite switching 
is not allowed 
False} ] 
satellite switching 
is allowed 
[<MBGOPTS> {MGB 
Multiple Multiple Business 
Business Group 
Group option 
<type> {Local 
group type 
National} 
<id> {0 to 
group ID 4294967295} 
digit stream 
<lp> {0 to 255} 
line privileges digit stream 


Note: See Table 1-59 for additional information on required TR parameters. 
Note: Required parameters are enclosed by < >. Optional parameters are enclosed by [ ]. Options 
within optional parameters are enclosed by { }. 


—continued— 
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Table 1-60 
Optional TR parameters - CLLI (continued) 


Note: Additional parameters select 
trunk type and refinements (as 
required). 


{FGD 
[<infodigs 
_option> 


{FGDSNC 
[<infodigs 
_option> 


Optional Additional Additional Additional Additional 
parameter optional optional optional optional 
parameter/ parameter/ parameter/ parameter/ 
response response response response 
(if required) (if required) (if required) (if required) 
<gap> {N} 
translation 
number {0 to 9} ] 
digit stream; 
max 14 digits 
[<TRIGOPT> {trig <pic> {All 
Trigger 
Origin 
Collect} 
<access 
_type> 


{infodigs 
<infodigs_value> 
string} ] 


{infodigs 
<infodigs_value> 
string} ] 


Note: See Table 1-59 for additional information on required TR parameters. 


within optional parameters are enclosed by { }. 


Note: Required parameters are enclosed by < >. Optional parameters are enclosed by [ ]. Options 


—continued— 
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Additional 
optional 
parameter/ 


Table 1-60 
Optional TR parameters - CLLI (continued) 
Optional Additional 
parameter optional 
parameter/ 
response 


(if required) 


response 
(if required) 


Additional 
optional 
parameter/ 
response 
(if required) 


Additional 
optional 
parameter/ 
response 
(if required) 


{FGDCUT 
[<infodigs 
_option> 


{FGDTRANS 
[<infodigs 
_option> 


{UAAUTH 
[<infodigs 
_option> 


{UACARD 
[<infodigs 
_option> 


{PRI 


{DAL 


{EDAL 


{ONAL 


{ONAT 


{infodigs 
<infodigs_value> 
string} | 


{infodigs 
<infodigs_value> 
string} ] 


{infodigs 
<infodigs_value> 
string} ] 


{infodigs 
<infodigs_value> 
string} ] 


Note: See Table 1-59 for additional information on required TR parameters. 
Note: Required parameters are enclosed by < >. Optional parameters are enclosed by [ ]. Options 
within optional parameters are enclosed by { }. 


—continued— 
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Table 1-60 
Optional TR parameters - CLLI (continued) 
Optional Additional Additional Additional Additional 
parameter optional optional optional optional 
parameter/ parameter/ parameter/ parameter/ 
response response response response 
(if required) (if required) (if required) (if required) 
{GTWIMT 
{ESNPRI 
{Other 
{ESP} 
<call_type> 


Note: Additional parameters select call 
types (as required). 
ONNET 
OFFNET 
IDDD 
NOO 


1800 


TIE 


Note: See Table 1-59 for additional information on required TR parameters. 
Note: Required parameters are enclosed by < >. Optional parameters are enclosed by [ ]. Options 
within optional parameters are enclosed by { }. 


—continued— 
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Table 1-60 
Optional TR parameters - CLLI (continued) 
Optional Additional Additional Additional Additional 
parameter optional optional optional optional 
parameter/ parameter/ parameter/ parameter/ 
response response response response 
(if required) (if required) (if required) (if required) 
WATS 
IVPN 
ZPLUSOFFNET 
ZPLUSONNET 
INTOA 
IGA 
IDA 
GVPN 


Undetermined 


Other} 


<criteria> 


Note: Additional parameters select 
calling criteria. 


Note: See Table 1-59 for additional information on required TR parameters. 
Note: Required parameters are enclosed by < >. Optional parameters are enclosed by [ ]. Options 
within optional parameters are enclosed by { }. 


—continued— 
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Table 1-60 
Optional TR parameters - CLLI (continued) 
Optional Additional Additional Additional Additional 
parameter optional optional optional optional 
parameter/ parameter/ parameter/ parameter/ 
response response response response 
(if required) (if required) (if required) (if required) 
{NIL 
{TRI 


{REDIRECTION 


{CONFERENCE 
}}]} 


Note: See Table 1-59 for additional information on required TR parameters. 


Note: Required parameters are enclosed by < >. Optional parameters are enclosed by [ ]. Options 
within optional parameters are enclosed by { }. 


—end— 
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Table 1-61 
Optional TR parameters - DIGITS 
Optional Additional Additional Additional Additional 
parameter optional optional optional optional 
parameter/ parameter/ parameter/ parameter/ 
response response response response 
(if required) (if required) (if required) (if required) 
[<CDNIE> {cdn 
Called Party 
Number Option 
[<npi> 
Numbering 
Plan Indicator 
(NPI) Option 
{<pub> 
public NPI 
<E164> 
public NPI 
(default) 
<pvt>} ] 
private NPT 
[<cdnton> 
Called Party 
Number Type of 
Number 
{in 
international 
number 


Note: See Table 1-59 for additional information on required TR parameters. 


Note: Required parameters are enclosed by < >. Optional parameters are enclosed by [ ]. Options 
within optional parameters are enclosed by { }. 


—continued— 
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Table 1-61 
Optional TR parameters - DIGITS (continued) 
Optional Additional Additional Additional Additional 
parameter optional optional optional optional 
parameter/ parameter/ parameter/ parameter/ 
response response response response 
(if required) (if required) (if required) (if required) 
{na 
10-digit number 
{l 
7-digit public 
number 
{net 
variable private 
number 
{abbr 
abbreviated 
number 
{unk} ] 
unknown 
<cdn> string}] 
calling number 
display/delivery 
option 
[<NSF> {owtsid [<facnum> {0 to 32767} | 
Network Outgoing WATS facility number digit stream 
Specific Identification 
Facility 


Note: See Table 1-59 for additional information on required TR parameters. 
Note: Required parameters are enclosed by < >. Optional parameters are enclosed by [ ]. Options 
within optional parameters are enclosed by { }. 


—continued— 
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Table 1-61 


Optional TR parameters - DIGITS (continued) 


Optional 
parameter 


Additional 
optional 
parameter/ 
response 
(if required) 


Additional 
optional 
parameter/ 
response 
(if required) 


Additional 
optional 
parameter/ 
response 
(if required) 


Additional 
optional 
parameter/ 
response 
(if required) 


prvt 
Private 


{wt 
INWATS 


owt 
OUTWATS 


fx> 
Foreign 
Exchange 


tie 
TIE line 


asds 


[<facnum> 
facility number 


[<facnum> 
facility number 


<zone> 


[<facnum> 
facility number 


[<facnum> 
facility number 


{0 to 32767} ] 
digit stream 


{0 to 32767} ] 
digit stream 


{0 to 9; 
A, B, C, NONE}] 
digit stream 


{0 to 1023} ] 
digit stream 


{0 to 1023} ] 
digit stream 


Note: See Table 1-59 for additional information on required TR parameters. 
Note: Required parameters are enclosed by < >. Optional parameters are enclosed by [ ]. Options 
within optional parameters are enclosed by { }. 


—continued— 
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Table 1-61 
Optional TR parameters - DIGITS (continued) 
Optional Additional Additional Additional Additional 
parameter optional optional optional optional 
parameter/ parameter/ parameter/ parameter/ 
response response response response 
(if required) (if required) (if required) (if required) 
Ids} ] 
Local Digital 
Switch 
[<TNSIE> {tns <tnston> {US 
Transit Transit Network public carrier 
Network Selection Type digits 
Selection of Number 
NA} 
private carrier 
digits 
<tnsnpi> {UNK 
Transit Network unknown 
Selection Protocol 
Preference CIC 
indicator carrier 
identification 
code 
US} 


public carrier 
digits 


Note: See Table 1-59 for additional information on required TR parameters. 
Note: Required parameters are enclosed by < >. Optional parameters are enclosed by [ ]. Options 
within optional parameters are enclosed by { }. 


—continued— 
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Table 1-61 
Optional TR parameters - DIGITS (continued) 
Optional Additional Additional Additional Additional 
parameter optional optional optional optional 
parameter/ parameter/ parameter/ parameter/ 
response response response response 
(if required) (if required) (if required) (if required) 
<tns_digits> string}] 


Transit Number 
Selection digits 


[<OSAIE> {osa <osaton> {<pubp string 
<puba string 
<pri}}] string 

[<BC> {bc <bcname> string} ] 

Bearer 

Capability 

Name 

[<SR> {SR <SR1> {cug 

Service ; 

Requested : cli 

Option f 

<SR4> nnd 
cfw} ]}] 
[<PI> {pi <prefind> {noisuprq 


Note: See Table 1-59 for additional information on required TR parameters. 
Note: Required parameters are enclosed by < >. Optional parameters are enclosed by [ ]. Options 
within optional parameters are enclosed by { }. 


—continued— 
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Table 1-61 
Optional TR parameters - DIGITS (continued) 
Optional Additional Additional Additional Additional 
parameter optional optional optional optional 
parameter/ parameter/ parameter/ parameter/ 
response response response response 
(if required) (if required) (if required) (if required) 
isuppref 
supreq} } ] 
[<TRI> {tri <tridigs> string} ] 
<NETINFO> {netinfo <netid> {0 to 32767} 
digit stream 
<netcgid> {0 to 4095} 
digit stream 


Note: See Table 1-59 for additional information on required TR parameters. 
Note: Required parameters are enclosed by < >. Optional parameters are enclosed by [ ]. Options 
within optional parameters are enclosed by { }. 


—continued— 
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TRAVER (continued) 


Table 1-61 
Optional TR parameters - DIGITS (continued) 
Optional Additional Additional Additional Additional 
parameter optional optional optional optional 
parameter/ parameter/ parameter/ parameter/ 
response response response response 
(if required) (if required) (if required) (if required) 
<ncos> {0 to 255} } J 
digit stream 
[<FINFO> {finfo <dig1> {string 
First In : : 
First Out 
<dig4> string} ] 
[<RPOAP> {rpoap <rpoap 4 digits> string} ] 
[<RPOAS> {rpoas <rpoas 4 digits> string} ] 
[<NOA> {noa <nature of {0 to 127}}] 
Nature of address> digit stream 
Address 
[<AINCHG> {ainchg <digits> string} ] 
[<AIN_INFO> {ainres <version> {r01] 
<res_type>> {nores 


Note: See Table 1-59 for additional information on required TR parameters. 


Note: Required parameters are enclosed by < >. Optional parameters are enclosed by [ ]. Options 
within optional parameters are enclosed by { }. 


—continued— 
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TRAVER (continued) 


Table 1-61 


Optional TR parameters - DIGITS (continued) 


<clginfo> 


<chrginfo> 


{clginfo <calling 
noa> 


<calling number> 


{chrginfo 
<charge noa> 


<charge number> 


Optional Additional Additional Additional Additional 
parameter optional optional optional optional 
parameter/ parameter/ parameter/ parameter/ 
response response response response 
(if required) (if required) (if required) (if required) 
ar 
fc 
cont} } ] 
[<SCAIIN> {scaiin <called noa> {0 to 127} 
digit stream 


{0 to 127} 
digit string 


string} ] 


0 to 127} 
digit string 


string} ] } ] 


Note: See Table 1-59 for additional information on required TR parameters. 
Note: Required parameters are enclosed by < >. Optional parameters are enclosed by [ ]. Options 
within optional parameters are enclosed by { }. 


—end— 
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Table 1-62 
Optional TR parameters - TRACE 
Optional Additional Additional Additional Additional 
parameter optional optional optional optional 
parameter/ parameter/ parameter/ parameter/ 
response response response response 
(if required) (if required) (if required) (if required) 
[<TRACE> [<trceopt> <rteopt> V <vig> string 
N <num> {1 to 32} 
digit string 
ALL} } ]> 
[<TRACE> <nrr> [nrr} ] 
[<TRACE> <authcode> string} 
[<TRACE> <mfst_cdn> {nil 
st8p 
st2p 
st 
stkp 
cic <cic_digits> string} ] 


Note: See Table 1-59 for additional information on required TR parameters. 
Note: Required parameters are enclosed by < >. Optional parameters are enclosed by [ ]. Options 
within optional parameters are enclosed by { }. 


—end— 
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Table 1-63 
Required R parameters 
Required Value Description Optional 
parameter parameters 
R — R is entered when a routing table is the originator. 
Optional parameters include table names and their 
variables. 


Note: The DIGITS and TRACE options required with TR 
originations are ignored with R originations. 


(16 alphanumeric 


“R”, 


<TABLE> string Table Name 


characters) Note: The TABLE name must 
be entered immediately after 


{HNPARTE 
Home Numbering 
Plan Route 


{FNPARTE 
Foreign Numbering 
Plan Route 


{STSRTE 
FNPA Route 


{OFRT 
Office Route 


{IBNRTE 
Routing Reference 


PXRTE 
Universal Translation 


FARTE 
Foreign Area 
Code Route 


—continued— 
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TRAVER (continued) 


Table 1-63 


Required R parameters (continued) 


Required 
parameter 


Value 


Description 


Optional 
parameters 


OFCRTE 
Office Code Route 


CTRTE 
Country Code Route 


IBNRT2 
Routing Reference 2 


IBNRT3 
Routing Reference 3 


IBNRT4 
Routing Reference 4 


OFR2 
Office Route 2 


OFR3 
Office Route 3 


OFR4 
Office Route 4 


—end— 
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TRAVER (continued) 


Table 1-64 


Optional R parameters - TABLE 


Numbering Plan 
Area Control 
Table 


Optional Additional Additional Additional Additional 
parameter optional optional optional optional 
parameter/ parameter/ parameter/ parameter/ 
response response response response 
(if required) (if required) (if required) (if required) 
{HNPARTE <HNPA> {0 to 999} 
Home Numbering digit string 
Plan Area Control 
Table 
(HNPACONT) 
<RTEREF> {1 to 1023} 
Routing digit stream 
Reference 
Subtable Key 
{FNPARTE <FNPA> {0 to 999} 
Foreign digit string 
Numbering Plan Table FNPA 
Area Control Route Index 
Table 
(FNPACONT) 
<RTEREF> {1 to 1023} 
Table digit stream 
{STSRTE <FNPA> {0 to 999} 
Foreign digit string 


Note: See Table 1-63 for additional information on required R parameters. 
Note: Required parameters are enclosed by < >. Optional parameters are enclosed by [ ]. Options 
within optional parameters are enclosed by { }. 


—continued— 
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Table 1-64 


Optional R parameters - TABLE (continued) 


Optional Additional Additional Additional Additional 
parameter optional optional optional optional 
parameter/ parameter/ parameter/ parameter/ 
response response response response 
(if required) (if required) (if required) (if required) 
<STS> {0 to 999} 
Serving digit stream 
Translation 
Scheme 
<RTEREF> {1 to 1023} 
digit stream 
{OFRT <RTEREF> {1 to 1023} 
digit string 
{IBNRTE <RTEREF> {1 to 1023} 
digit string 
{PXRTE <XLANAME> String 
<RTEREF> {1 to 1023} 
digit string 
{FARTE <XLANAME> String 
<RTEREF> {1 to 1023} 
digit string 
{OFCRTE <XLANAME> String 


Note: See Table 1-63 for additional information on required R parameters. 
Note: Required parameters are enclosed by < >. Optional parameters are enclosed by [ ]. Options 
within optional parameters are enclosed by { }. 


—continued— 
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TRAVER (continued) 


Table 1-64 
Optional R parameters - TABLE (continued) 
Optional Additional Additional Additional Additional 
parameter optional optional optional optional 
parameter/ parameter/ parameter/ parameter/ 
response response response response 
(if required) (if required) (if required) (if required) 
<RTEREF> {1 to 1023} 
digit string 
{IBNRT2 <RTEREF> {1 to 1023} 
digit string 
{IBNRT3 <RTEREF> {1 to 1023} 
digit string 
{IBNRT4 <RTEREF> {1 to 1023} 
digit string 
{OFR2 <RTEREF> {1 to 1023} 
digit string 
{OFR3 <RTEREF> {1 to 1023} 
digit string 
{OFR4 <RTEREF> {1 to 1023} 
digit string } 
Note: See Table 1-63 for additional information on required R parameters. 
Note: Required parameters are enclosed by < >. Optional parameters are enclosed by [ ]. Options 
within optional parameters are enclosed by { }. 
—end— 


Example command 
The following is an example TRAVER command entry with a TR originator. 


>TRAVER TR DAL237TWDTLS 2133603789 B 
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TRAVER (continued) 


Responses 


The following is an example response to the TRAVER command: 


>TRAVER TR DAL237TWDTLS 2133603789 B 

STS USED FOR TRAVER IS: 611 

TABLE STSTOPAR 

611 00 11 

TABLE TRKGRP 

DAL237TWD TLS DAL 127 NPDGP NCON 0 2W DAL MIDL 16 7 16 16 S 
10 NIL DL 7 5 111 MANUAL 214 0 NOAUTHS RTE8 0 VOICE_DATA Y 1 
N Y NONE 00 (QHQ) (ACPROMPT) $ 

TABLE STDPRTCT 

DAL (1) (0)0 
SUBTABLE STDPRT 

WARNING: CHANGES IN TABLE STDPRT MAY ALTER OFFICE BILLING. 
CALL TYPE DEFAULT IS NP. PLEASE REFER TO DOCUMENTATION. 

21 21 CT OFFNET 8 10 0 
WARNING: CHANGES IN TABLE STDPRT MAY ALTER OFFICE BILLING. 
CALL TYPE DEFAULT IS NP. PLEASE REFER TO DOCUMENTATION. 
TABLE HNPACONT 
611 991 10 (195) (1) (0) (0) 1 

SUBTABLE HNPACODE 

-213 216 HNPA 0 
-630 630 LRTE 630 
. SUBTABLE RTEREF 
-630 S D EAN630TWMFWK 
-EXIT TABLE RTEREEF 
EXIT TABLE HNPACONT 
+++TRAVER: SUCCESSFUL CALL TRACE+++ 
STS USED FOR TRAVER IS: 611 
DIGIT TRANSLATION ROUTES 
1 EAN630TWMFWK 2136306789 ST 
1 DIGITS_003 
+++TRAVER: SUCCESSFUL CALL TRACE+++ 


The following is an example response with CAIN information to a TRAVER 
command: 


PTS DAL to PTS DAL with subscription on trunk group basis; trigger 
CUSTDP with trigger action QUERY 


>TRAVER TR DAL220TWDTGS 2142221234 B 
STS USED FOR TRAVER IS: 611 

TABLE STSTOPAR 

611 00 111 

TABLE TRKGRP 
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TRAVER (continued) 


DAL220TWDTGS DAL 30 NPDGP NCIT 0 2W DAL MIDL 16 7 1616S 7 
NIL ID 0 7 111 
MANUAL 214 0 6113311 RTE2 0 3_1KHZ Y 1 N Y ANISNPA 00 160 
(MCCS ) 
(ALTTRTMT ) (VANIDB ) (CAIN ) (CAINGRP CUSTGRP) (LATA 
LATA1) $ 
TABLE LATAID 
LATA1 214 
--> ENTER TDP ORIGATT <-- 
+++ CAIN SUBSCRIPTION VIA AGENT +++ 
TABLE CAINGRP 
CUSTGRP 3 CAINO2 TCAP_SCCP (ANLZINFO INFOANLZ CUSTDP) $ $ 
(ADIN ) (CAINGRP ) 
(ORGTINFO ) $ $ 
--> ENTER TDP O_FTRREQ <-- 
+++ CAIN SUBSCRIPTION VIA AGENT +++ 
TABLE CAINGRP 
CUSTGRP 3 CAINO2 TCAP_SCCP (ANLZINFO INFOANLZ CUSTDP) $ $ 
(ADIN ) (CAINGRP ) 
(ORGTINFO ) $ $ 
--> ENTER TDP INFOCOLL <-- 
+++ CAIN SUBSCRIPTION VIA AGENT +++ 
TABLE CAINGRP 
CUSTGRP 3 CAINO2 TCAP_SCCP (ANLZINFO INFOANLZ CUSTDP) $ $ 
(ADIN ) (CAINGRP ) 
(ORGTINFO ) $ $ 
TABLE STDPRTCT 
DAL (1) ( 0) 3 
SUBTABLE STDPRT 
WARNING: CHANGES IN TABLE STDPRT MAY ALTER OFFICE 
BILLING. CALL TYPE DEFAULT IS NP. PLEASE REFER TO 
DOCUMENTATION. 
21 21 CT OFFNET 7 10 0 $ 
WARNING: CHANGES IN TABLE STDPRT MAY ALTER OFFICE 
BILLING. CALL TYPE DEFAULT IS NP. PLEASE REFER TO 
DOCUMENTATION. 
TABLE HNPACONT 
611 Y 999 10 ( 460) (1) ( 0) ( 0) 4 $ 
SUBTABLE HNPACODE 
214 216 HNPA 0 
222 222 LRTE 222 
SUBTABLE RTEREF 
222 S D DAL222TWDTLS 
. EXIT TABLE RTEREF 
EXIT TABLE HNPACONT 
--> ENTER TDP INFOANLZ <-- 
+++ CAIN SUBSCRIPTION VIA AGENT +++ 
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TRAVER (end) 


TABLE CAINGRP 

CUSTGRP 3 CAINO2 TCAP_SCCP (ANLZINFO INFOANLZ CUSTDP) $ $ 
(ADIN ) (CAINGRP ) (ORGTINFO ) $ $ 
TABLE CUSTDP 
CUSTGRP ADDR 2142221234 215 QUERY ROUTE $ 


UserID: CAIN DAL220TWDTGS 11 
BearerCapability: SPEECH 
CalledPartyID: 2142221234 
TriggerCriteriaType: CUST_INT 
CallingPartyID: 214 


LATA: 214 


+++ TRAVER: SUCCESSFUL CALL TRACE +++ 


STS USED FOR TRAVER IS: 611 


DIGIT TRANSLATION ROUT 


Gl 
Nn 


1 DAL222TWDTLS 2221234 ST 


GI 


TREATMENT ROUT! 
1 DIGITS_003 


S. TREATMENT IS: GNCT 


+++ TRAVER: SUCCESSFUL CALL TRACE +++ 


Related commands 
None 
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VPTRACE 
Purpose 
The Variable Advanced Intelligent Network Messaging Platform Trace 
(VPTRACE) command enables/disables the tracing of variable AIN 
messaging platform (VAMP) messages. Messages are logged as VAMP901 
(inbound messages) or VAMP902 (outbound messages). 
CAUTION 
Using VPTRACE incurs real-time cost 
Enabling VAMP 90x message tracing logs incurs a 
real-time cost on every AIN message sent or received. 
This can affect call processing capacity during high traffic 
periods. Enable these logs during low traffic periods or 
when necessary to debug a messaging problem. 
Access 
Accessible from the MAP level. 
Syntax 
>VPTRACE logcmd 
Parameters 
Command parameters are described in Table 1-65. 
Table 1-65 
VPTRACE parameter descriptions 
Parameter Values Description 
logemd Valid values include: —§ Enables/disables the VAMP 90x logs. 


e ENABLE 
e DISABLE 


—end— 
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VPTRACE (end) 


Example command 
>VPTRACE ENABLE 


Responses 
The following is an example response to the VPTRACE command: 


>VPTRACE DISABLE 
VAMP MESSAGE TRACE LOGS DISABLED 


The following responses may display as a result of the VPTRACE 
command: 


VAMP MESSAGE TRACE LOGS DISABLED 


Explanation: 
VAMP message tracing is disabled. No further messages will be 
logged. 


User action: 
None 


VAMP MESSAGE TRACE LOGS ENABLED 


Explanation: 
VAMP message tracing is enabled. All inbound and outbound 
messages will be logged. 


User action: 
None 


Related commands 
None 
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CTMPLT 


Purpose 


The Call Detail Record Template (CTMPLT) command allows you to enter 
the CTMPLT directory and perform various display and editing functions. 


Note: CTMPLT commands use semaphores to enforce the mutual exclusion 
of the CTMPLT and table control commands. Although only one process 
can update table CDRTMPLT at any time, multiple processes can read the 
table at the same time. 


The CTMPLT (CDR Template) command set allows you to: 


Restrictions 


apply changes to the billing system (Changes to the billing system are 
made through office parameters in table OFCENG.) 


display the CDR templates defined in table CDRTMPLT 
copy existing templates 


display the CDR fields, including the size and format of data stored in 
the field 


display the current billing record status 


Restrictions associated with the CTMPLT command include: 


Access 


the predefined UCSO05, UCS06, and UCS08 CDR templates are not 
supported in the current UCS12 release 


the PIC, TDP, TRIGGER, and RTELIST fields that previously existed 
and then were removed, are re-added 


the information from PIC, TDP, and TRIGGER fields, can be defined in 
the user definable templates, and output through the FLEXCDR flexible 
billing capabilities. 

since CDR size has changed, downstream billing must be upgraded to 
the UCSO9 CDR format, if the UCSO9 CDR format is enabled. 


existing SOC UBFRO001, Flexible CDR, must be active to edit table 
CDRTMPLT. 


existing SOC UBFRO001, Flexible CDR, must be active to provision the 
CDRTMPLT option. 


All CTMPLT commands are accessed through the CTMPLT directory. 
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CTMPLT (continued) 


Syntax 
>CTMPLT 


Parameters 
None 


Example command 
>CTMPLT 


Responses 


If a CTMPLT command process attempts to update table CDRTMPLT while 
another process is already changing the table, the command returns the 
following response: 


Table CDRTMPLT is being written to by another process. Try 
again. 
Related commands 
The following commands are found in the CTMPLT directory: 
e COPY 
e FLDINFO 
e QUIT 
e REPORT 
e RESTORE 
e SET 
e STATUS 
e TDUMP 
e TEMPLATE 
e TLIST 
e TMPDESC 
e UPGRADE 
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COPY 


Purpose 


The Copy (COPY) command allows an existing table entry (from the edit 
index) to be copied to a new location in the table. The identified “from key” 
must exist in the table; the “to key” must not exist in the table. When 
successful, a copy of the defined template is stored at the next free slot in the 
table with the new key. A new template ID is automatically allocated. 


The COPY command is blocked during the following conditions when the 
Supernode Data Manager (SDM) is connected to the switch. Suitable 
warning messages display through the CTMPLT command. 


e Ifthe CDR data stream on the SDM is not in service, off-line, or in a 
recovery state, the COPY command is canceled. (The updates to 
FLEXCDR data are only allowed when the CDR stream is in required 
valid state.) 


e When the copied template is sent from the Computing Module (CM) to 
the SDM, and the communication between CM and SDM fails, CM is 
not updated. The COPY command is canceled. 


Access 
>CTMPLT 
Syntax 
>COPY from key to key 
Parameters 
Command parameters are described in Table 1-66. 
Table 1-66 
COPY parameter descriptions 
Parameter Values Description 
from key string Information is copied from this existing 
(1 to 16 alphanumeric CDRTMPLT table entry. 
characters) 
to key string Information is copied to the next available 
(1 to 16 alphanumeric CDRTMPLT table entry. 
characters) 


Note: The key name may not currently exist, but 
will be created by this command. 


—end— 
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COPY (end) 


Example command 
>COPY UCS09 MY_CDR 
MY_CDR template created in Index 10 of the CDRTMPLT table. 
The source for this template is the UCSO9 template. 


Responses 
None 


Related commands 
The following commands are related to this command: 


e FLDINFO 
e QUIT 

e REPORT 

e RESTORE 
e SET 

e STATUS 

e  TDUMP 

e TEMPLATE 
e  TLIST 

e TMPDESC 
e UPGRADE 
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FLDINFO 


Purpose 


The Field Information (FLDINFO) command displays information on each 
CDR field that can be provisioned in table CDORTMPLT. Field type 
information includes the following: 


Access 


field size (in bits) 


format of the field (for example, binary, string, or digits) 


attribute in effect for the field and the attribute set 


information about what the field is and how it is captured by call 


processing 


meaning of field values (where available) 


>CTMPLT 


Syntax 


>FLDINFO <FIELD CDR field | ALL> 


Parameters 


Command parameters are described in Table 1-67. 


Table 1-67 


FLDINFO parameter descriptions 


Parameter 


Values Description 


FIELD 


CDR field CDR subfield(s) include: 


ACCTCD—Account Code 

ACCTV—Account Code Validation 
ACG—Automatic Call Gapping 
ACTIDX—Active Template Identification Index 
ADDRNUM—Address Number 
ADIN—Authcode Database Index 
ALTBILL—AMA Alternate Billing Number 


—continued— 
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FLDINFO (continued) 


Table 1-67 
FLDINFO parameter descriptions (continued) 
Parameter Values Description 
AMABAFMD 


AMACALLT 

AMACALLC—BAF call code 
AMAMOD1—BAF module code 
AMAMOD2—BAF module code 
AMASC—BAF structure code 
AMASIZE 

ANICPN—BAF ANI/CPN indicator 


ANISP—Automatic Number Identification 
(ANI) Spill 


ANISUFF—Automatic Number Identification 
(ANI) Suffix 


ANSCDR—Answer CDR 
ANSTYPE—Answer Type 
BAF—Bellcore AMA Format 
BILLNUM—Billing Number 
BILLTYPE—Billing Type 
CAINCT—Carrier Advanced Intelligent Call 
Type 

CALLDUR—Call Duration 
CALLEDNO—Called Number 
CALLEVTS—BAF call event status 
CALLTYPE—FlexDial Call Type 
CARRSEL—Carrier Selected 
CDRALGOR—CDR Algorithm 
ClC—Carrier Identification Code 


—continued— 
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FLDINFO (continued) 


Table 1-67 
FLDINFO parameter descriptions (continued) 


Parameter Values 


Description 


CICCASU—Carrier Identification Code Casual 
Usage 


CICORIGIN—Carrier Identification Code 
Origination 


CLDNOA—Called Party Nature of Address 
CLGNOA—Calling Party Nature of Address 
CLGPTYNO—Calling Party Number 
CN1REQ—CAIN First Request 
CN2REQ—CAIN Second Request 
CN3REQ—CAIN Third Request 
CN1TREQ—CAIN First Request Totals 
CN2TREQ—CAIN Second Request Totals 
CN3TREQ—CAIN Third Request Totals 
CNTOTREQ—CAIN Request Totals 
CNPREDIG—Calling Party Number Prefix 
Digits 

COLLTIME—Collection Time 
COMPCODE—Call Completion Code 
COMPCODE2 

COSINDEX—Class of Service Index 
COSOVE—Class of Service Override 
CRID—Call Reference Identifier for PSN 
DCR—Dynamic Call Routing 
DIALEDNO—Dialed Number 
DIALNOA—Dialed Number Nature of Address 
DIGDATA—Digit Data 


—continued— 
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FLDINFO (continued) 


Table 1-67 
FLDINFO parameter descriptions (continued) 


Parameter Values 


Description 


DIGIDJIP—Digit Identifier for JIP 
DIGIDNPA—Digit Identifier for NPA 
DIGIDTRN—Digit Identifier for TRN 


DISC10TH—Disconnect time 10ths of a 
second 


DISCAMPM—Disconnect AM/PM 
DISCDATE—Disconnect Date 
DISCTIME—Disconnect Time 
DISCTYPE—Disconnect Type 


DISCYEAR—Least significant digit of call 
disconnect year 


DLPRESUB—BAF dialing and presubscription 
indicator 


DNIS—Dialed Number Identification Services 
DNISNOA—DNIS Nature of Address 
ECRM1—Echo Canceler Resource Module 1 
ECRM2—Echo Canceler Resource Module 2 
ECRN1—Echo Canceler Resource Number 1 
ECRN2—Echo Canceler Resource Number 2 
EXPOPCH—Expand Operator Choice Index 
FILL1—One Bit Filler 

FILL2—Two Bit Filler 

FILL8—Three Bit Filler 

FILL4—F our Bit Filler 

FILL8—Eight Bit Filler 

FINSID—Final Switch Identifier 
FINTKGRP—Final Switch Group 


—continued— 
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FLDINFO (continued) 


Table 1-67 
FLDINFO parameter descriptions (continued) 


Parameter Values 


Description 


FINTKMEM—Final Switch Member 

HEXID 

INCBILL—Incremental Billing 
INCINTL—Incoming International 
INFODIG—Information Digits 

LATA—BAF call LATA 

LENGTH—Record length 

LNPCHECK—Local Number Portability Check 


LRNSRC1—BAF Location Routing Number 
Identifier 


LRNSRC2—BAF Location Routing Number 
Identifier 


MLTCOSID—Multiple Class of Service Index 
MODMAP 
NETOPNO—Network Outpulsed Number 


NETOPNOA—Network Outpulsed Number 
Nature of Address 


NETSEC—Network Security 
NUMADDRS—Number of Addresses 
NUMWBCKT—Number of Wideband Circuits 
OACESID—Originating Access ID 
OPART—Originating Partition Number 
OPERINV 


ORIG10TH—Origination time 10ths of a 
second 


ORIGAMPM—Originate AM/PM 
ORIGDATE—Origination Date 


—continued— 
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FLDINFO (continued) 


Table 1-67 
FLDINFO parameter descriptions (continued) 


Parameter Values 


Description 


ORIGECHO—Originating Echo Canceller 
ORIGGRP—Originating Trunk Group 


ORIGLRN—Originating Location Routing 
Number 


ORIGMEM—Originating Trunk Member 
ORIGOPRT—Originating Partition Number 
ORIGPVN—Originating Private Number 


ORIGSTS—Originating Service Translation 
Scheme 


ORIGTIME—Originating Time 


ORIGYEAR—Least significant digit of call 
origination year 


OSRASSOC—Operator Services Record 
Associated 


OTPULNOA—Outpulsed Number Nature of 
Address 


OUTNOA—Outgoing Number Nature of 
Address 


OUTPULNO—Ouipulsed Number 
OVERFLOW—Overflow Indicator 
PASSTHRU—Pass Through 

PIC—Point in Call 

PINDIGS—Personal Identification (PIN) Digits 
PORTEDNO—Ported Number 
PREDIG—Prefix Digits 
PRESIND—Presentation Restriction Indicator 
PRJCODE—Project Code 

QRYSTIND—BAF query status indicator 


—continued— 
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FLDINFO (continued) 


Table 1-67 
FLDINFO parameter descriptions (continued) 


Parameter Values 


Description 


QUEUED—Queued 
RECCD—Record code 
RELCAUSE—Release Cause 
REORGCTR—Reorgination Counter 
RLTCDR—Release Line Trunk CDR 
ROUTIND 


RTEINDEX—Number from Route Table used 
to route a call 


RTELIST—Route List 

RTENO—Route Number 
RTETAB—Routing Table 
SCPBILL—Service Control Point Billing 
SEQNUM—Sequence Number 
SLPID—Service Line Provider Indicator 
STS—Service Translation Scheme 
SUBRIDX1—Subscriber Index 1 
SUBRIDX2—Subscriber Index 2 
SUBRLOG1—Subscriber Log 1 
SUBRLOG2—Subscriber Log 2 
SUBRNUM1—Subscriber Number 1 
SUBRNUM2—Subscriber Number 2 
SUBRTYP1—Subscriber Type 1 
SUBRTYP2—Subscriber Type 2 
SUBRVAL1—Subscriber Validation 1 
SUBRVAL2—Subscriber Validation 2 
SVCFTR 


—continued— 
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FLDINFO (continued) 


Table 1-67 
FLDINFO parameter descriptions (continued) 


Parameter Values 


Description 


ALL 


e TDP—Trigger Detection Point 

e TEMPLID—Template identifier 

e TERMECHO—Terminating Echo Canceller 
e TERMGRP—Terminating Echo Group 


e TERMLRN—Terminating Location Routing 
Number 


e TERMMEM—Terminating Trunk Member 
e TERMPLAN 

e ORIGPLAN 

e EXOSEAS 

e TERMPVN—Terminating Private Number 
e TIMECHNG—Time Change 

e TIMEGARD—BAF timing guard condition 
e TOOLGEN—Tool generated 

e TPART—Terminating Partition Number 

e TRAP—Trap 

e TRIGGER—Trigger 

e TRKGRP—BAF trunk group number 

e TRMOSEAS 

e TRIMTCD—Treatment Code 

e UNIVACC—Universal Access Code 

e USEEDIT—Editing index used 

e VARLNGTH—Variable length 

e WBCKTS—Wideband Circuits 


Displays all subfields associated with the CDR 
field. 


—end— 
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FLDINFO (continued) 


Example commands 


The following examples display information about the various CDR field 


types: 


>FLDINFO FIELD EXPOPCH 


Field Name: EXPOPCH 


Field Size: 10 
MIN Split Size: 


bit (s) 
10 bits 


Attribute in Effect: DONTCARE 


Set Attribute: 


DONTCARE 


Description: Indicates the expanded index of TABLE OPCHOICE 


(range 0-1023) 
the SCP. 


used in the response message received from 


>FLDINFO FIELD PIC 


Field Name: PIC 


Field Size: 5 bit(s) 


MIN Split Size: 


Attribute in Effect: DONTCAR 


Set Attribute: 


5 bits 


GI 


DONTCARE 


Description: Indicates the point in call value where AIN 
trigger was activated. 


>FLDINFO FIELD TDP 


Field Name: TDP 


Field Size: 6 bit(s) 


MIN Split Size: 


6 bits 


Attribute in Effect: DONTCARE 


Set Attribute: 


DONTCARE 


Description: Indicates the AIN trigger detection point. 


>FLDINFO FIELD TRIGGER 
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FLDINFO (continued) 


Field Name: TRIGGER 

Field Size: 5 bit(s) 

MIN Split Size: 5 bits 
Attribute in Effect: DONTCAR 
Set Attribute: DONTCARE 
Description: Identifies the AIN trigger applied 


Gl 


>FLDINFO FIELD ALTBILL 


Field Name: ALTBILL 

Field Size: 44 bit(s) 

MIN Split Size: 4 bits 
Attribute in Effect: DONTCAR 
Set Attribute: DONTCARE 
Description: Indicates the AMAAlternateBillingNumber in the 
response message received from the SCP. 


Gl 


>FLDINFO FIELD ORIGYEAR 


Field Name: ORIGYEAR 

Field Size: 4 bit(s) 

MIN Split Size: 4 bits 

Attribute in Effect: DONTCARE 

Set Attribute: DONTCARE 

Description: Indicates the least significant number of the 
current year at call origination. 


>FLDINFO FIELD PRJCODE 
Field Name: PRJCODE 
Field Size: 32 bit (s) 

MIN Split Size: 4 bits 

Attribute in Effect: DONTCARE 

Set Attribute: DONTCARE 

Description: Indicates the Project code value in the TCAP 
message received from the SCP. 


>FLDINFO FIELD RTEINDEX 
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FLDINFO (end) 


Field Name: RTEINDEX 

Field Size: 14 bit(s) 

MIN Split Size: 14 bits 
Attribute in Effect: DONTCARE 
Set Attribute: DONTCARE 
Description: Indicates the number obtained from the route 
table used to route the call. 


>FLDINFO FIELD SLPID 


Field Name: SLPID 

Field Size: 36 bit (s) 

MIN Split Size: 4 bits 
Attribute in Effect: DONTCARE 
Set Attribute: DONTCARE 
Description: Indicates the AMAslpID value in the TCAP message 
received from the SCP. 


Responses 
None 


Related commands 
The following commands are related to this command: 


e COPY 

e QUIT 

e REPORT 

e RESTORE 
e SET 

e STATUS 

e  TDUMP 

e TEMPLATE 
e  TLIST 

e TMPDESC 
e UPGRADE 
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QUIT (end) 
Purpose 
Use the QUIT command to exit the CTMPLT CI directory. 
Access 
>CTMPLT 
Syntax 
>QUIT 
Parameters 
None 


Example command 
>QUIT 


Responses 
None 


Related commands 
The following commands are related to this command: 


e COPY 

e FLDINFO 

e REPORT 

e RESTORE 
e SET 

e STATUS 

e TDUMP 

e TEMPLATE 
e TLIST 

e TMPDESC 
e UPGRADE 
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Purpose 


The Report (REPORT) command provides an itemized summary of template 
use. Information located on the report includes: 


e the number of times a particular template has been used to format CDR 
records since the last report 


e the number of times each field within the template contained captured 
information in the formatted CDR record since the last report 


Access 
>CTMPLT 
Syntax 
>REPORT START | STOP | PRINT TEMPLATE template ID | ALL 
Parameters 
Command parameters are described in Table 1-68. 
Table 1-68 
REPORT parameter descriptions 
Parameter Values Description 
action START Start statistics collection. 
STOP Stop statistics collection. 
<PRINT template ID> Print selected templates. 
string 
(1 to 16 alphanumeric 
characters) 
PRINT ALL Print all templates. 
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REPORT (continued) 


Example command 
>REPORT START 
>REPORT STOP 


>REPORT PRINT UCS09 


TEMPLATE: UCSO9 - Number of CDR records formatted: 


Field Type # Times Used Field Type 
SEQNUM 9 CIC 
ORIGDATE 9 ANSTYPE 
DISCDATE 9 ANISUFF 
INCBILL 9 CALLDUR 
PINDIGS 9 ANISP 
BILLNUM 9 ACCTCD 
CLGPTYNO 9 RLTCDR 
ACCTV 9 UNIVACC 
DIALEDNO 9 CALLEDNO 
OUTPULNO 9 ORIGOPRT 
OPART 9 TPART 
RTELIST 0 RTENO 
OPCHOICE 9 COLLTIME 
ADIN 9 NUMWBCKT 
WBCKTS 9 FINSID 
BILLTYPE 9 ORIGGRP 
DISCTYPE 9 ORIGMEM 
PASSTHRU 9 TERMGRP 
PRESIND g TERMMEM 
FINTKGRP g FINTKMEM 
SCPBILL 9 TDP 
PIC 0 TRIGGER 
COMPCODE 9 CRID 
STS 0 PREDIG 
ACG 9 ADDRNUM 
ANSCDR 0 CAINCT 
CALLTYPE 0 CDRALGOR 
CLDNOA 0 CLGNOA 
CNPREDIG 9 COS INDEX 
COSOVE 9 DCR 
DIALNOA 0 DIGDATA 
DISCAMPM 9 DISCTIME 
DNIS 9 DNISNOA 
INCINTL 9 INFODIG 
MLTCOSID 9 NETOPNO 
NETOPNOA 0) NETSEC 
NUMADDRS 0 ORIGAMPM 
ORIGECHO 0 ORIGLRN 
ORIGPVN 9 ORIGSTS 
ORIGTIME g OSRASSOC 
OTPULNOA 0 OVERFLOW 
QUEUED 9 RELCAUSE 
REORGCTR 0 RTETAB 
SUBRIDX1 0 SUBRIDX2 
SUBRLOG1 0 SUBRLOG2 
SUBRNUM1 0 SUBRNUM2 
SUBRTYP1 0 SUBRTYP2 
SUBRVAL1 0 SUBRVAL2 
TERMECHO 0 TERMLRN 


9 


OOO COCO COCO O I0 O IO IO IO O IO IO IO IO O ģ⁄ O O IO O IO IO O O IO MO IO IO IO IO IO IO IO IO OW OM OOO O OO 


9 
# Times Used 
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TERMPVN 9 TIMECHNG 9 
TRAP 9 TRTMTCD 9 
CARRSEL 9 LNPCHECK 9 
PORTEDNO 9 OUTNOA 9 
CICCASU 9 CICORIGN 9 
CN1REQ 9 CN2REQ 9 
CN1TREQ 9 CN2TREQ 9 
CN3REQ g CNTOTREQ 9 
CN3TREQ 9 ECRM1 9 
ECRM2 9 ECRN1 9 
ECRN2 g RTEINDEX 9 
PRJCODE 0 SLPID 0 
AMASC 0 AMACALLC 0 
TIMEGARD 0 CALLEVTS 0 
TRKGRP 0 ANICPN 0 
DLPRESUB 0 LATA 0 
AMAMOD1 0 AMAMOD2 0 
LRNSRC1 0 LRNSRC2 0 
QRYSTIND 0 DISCYEAR 0 
DISC10TH 0 ORIGYEAR 0 
ORIG10OTH 0 


>REPORT PRINT ALL 


[The PRINT statistics command has been entered. 

TEMPLATE: RESERVEDO - Number of CDR records formatted: 0 
TEMPLATE: RESERVEDO1 - Number of CDR records formatted: 0 
TEMPLATE: RESERVEDO2 - Number of CDR records formatted: 0 
TEMPLATE: UCSO7 - Number of CDR records formatted: 0 


TEMPLATE: UCSO7FLEX - Number of CDR records formatted: 0 


TEMPLATE: UCSO9 - Number of CDR records formatted: 9 


Field Type # Times Used Field Type # Times Used 
SEQNUM 9 CIC 9 
ORIGDATE 9 ANSTYPE 9 
DISCDATE 9 ANISUFF 9 
INCBILL 9 CALLDUR 9 
PINDIGS 9 ANISP 9 
BILLNUM 9 ACCTCD 9 
CLGPTYNO 9 RLTCDR 9 
ACCTV 9 UNIVACC 9 
DIALEDNO 9 CALLEDNO 9 
OUTPULNO 9 ORIGOPRT 9 
OPART 9 TPART 9 
RTELIST 0 RTENO 9 
OPCHOICE 9 COLLTIME 9 
ADIN 9 NUMWBCKT 9 
WBCKTS 9 FINSID 9 
BILLTYPE 9 ORIGGRP 9 
DISCTYPE 9 ORIGMEM 9 
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REPORT (continued) 


PASSTHRU 
PRESIND 
FINTKGRP 
SCPBILL 
PIC 
COMPCODE 
STS 

ACG 
ANSCDR 
CALLTYPE 
CLDNOA 
CNPREDIG 
COSOVE 
DIALNOA 
DISCAMPM 


CN3REQ 
CN3TREQ 
ECRM2 
ECRN2 
PRJCODE 
AMASC 
TIMEGARD 
TRKGRP 
DLPRESUB 
AMAMOD1 
LRNSRC1 
QORYSTIND 
DISC10TH 
ORIG1OTH 


CO OCOOCOOCOOCO O O O O IO IO IO IO OO MO O O CE wLwOOOO OO O 0 O WO 0 O O O IO IO O 0 O O 0 OOO I O 0O O OO OO 


TERMGRP 
TERMMEM 
FINTKMEM 
TDP 
TRIGGER 
CRID 
PREDIG 
ADDRNUM 
CAINCT 
CDRALGOR 
CLGNOA 
COSINDEX 
DCR 
DIGDATA 
DISCTIME 
DNISNOA 
INFODIG 
NETOPNO 
NETSEC 
ORIGAMPM 
ORIGLRN 
ORIGSTS 
OSRASSOC 
OVERFLOW 
RELCAUSE 
RTETAB 
SUBRIDX2 
SUBRLOG2 
SUBRNUM2 
SUBRTYP2 
SUBRVAL2 
TERMLRN 
T 
ab 
L 
(0) 


IMECHNG 
RTMTCD 
NPCHECK 
UTNOA 
CICORIGN 
CN2REQ 
CN2TREQ 
CNTOTREQ 
ECRM1 
ECRN1 
RTEINDEX 
SLPID 
AMACALLC 
CALLEVTS 
ANICPN 
LATA 
AMAMOD2 
LRNSRC2 
DISCYEAR 
ORIGYEAR 


COO OC O O O O IO IO IO IO IO IO IO O O OC OC OO’0OO’OODOO O O O IO O LIO IO IO O IO IO IO IO IO WỌ O O IO O lO O O O io oO © 
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REPORT (end) 


TEMPLATE: RESERVEDO7 - Number of CDR records formatted: 
TEMPLATE: RESERVEDO8 - Number of CDR records formatted: 


TEMPLATE: RESERVEDO9 - Number of CDR records formatted: 


Responses 
None 


Related commands 
The following commands are related to this command: 


e COPY 

* FLDINFO 
e QUIT 

e RESTORE 
- SET 

e STATUS 

e  TDUMP 

e TEMPLATE 
e  TLIST 

e TMPDESC 
e UPGRADE 
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Purpose 


Access 
Syntax 


Parameters 


The Restore (RESTORE) command returns to the previous version of table 
CDRTMPLT as the active version. RESTORE performs the following: 


e verifies that multiple restores are not being attempted 


e verifies that a template being “turned off’ or removed is not referenced 
through the CDRTMPLT option of other tables or by any office 
parameter 


e prompts you to confirm the actual restore change 

e decrements the active and editing versions of indexes 

e updates the template at the new EDIT index, if appropriate 

e initiates a DIRP file and/or FP billing server file rotation (including GER 
and GSR event records) 


Note: RESTORE is limited to “going back” a single step; it does not 
support multiple restores. 


The RESTORE command is blocked during the following conditions when 
the Supernode Data Manager (SDM) is connected to the switch. Suitable 
warning messages display through the CTMPLT command. 


e Ifthe CDR data stream on the SDM is not in service, off-line, or in a 
recovery state, the RESTORE command is canceled. (The updates to 
FLEXCDR data are only allowed when the CDR stream is in required 
valid state.) 


e When the RESTORE command is sent from the computing Module 
(CM) to the SDM, and the communication between CM and SDM fails, 
CM is not updated. The RESTORE command is canceled. 


>CTMPLT 


>RESTORE < ACTIVE | HISTORY | EDIT> 


Command parameters are described in Table 1-69. 
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Table 1-69 
RESTORE parameter descriptions 
Parameter Values Description 
Edit version ACTIVE ACTIVE version of table CDRTMPLT becomes the 
selection (default) new EDIT version. 
HISTORY New ACTIVE version is copied forward to become 
the new EDIT version. 
EDIT Current EDIT version is copied back to become 
the new EDIT index. 


Example command 
>RESTORE HISTORY 


Responses 


The following responses may display as a result of the RESTORE 


command: 


A RESTORE has already been performed. Therefore, this RESTORE 


is denied. 


Explanation: 


If another RESTORE has been performed since the last UPGRADE, 
a subsequent RESTORE will not be allowed. 


System action: 


Denies the RESTORE. 


Another table references a tuple that has either been deleted 
or made inactive. Therefore, this RESTORE is denied. 


Explanation: 


Table TRKGRP has a reference to a Template ID that is inactive or 
deleted. Other tables that may be cited here include RTEATTR, 
AUTHCODU, AUTHCDUx (x=2-5), TRKFEAT, FLEXFEAT, 
STDPRTCT, FLEXTYPE, and ANISCUSP. Therefore, the 


RESTORE is denied. 


System action: 


Denies the RESTORE due to inter-table dependencies. 
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RESTORE (end) 


Are you sure (Y/N) 
Explanation: 
Confirmation that the RESTORE is accepted. 


System action: 
If confirmed, carry out the RESTORE. 


User action: 
Enter Y or N in response to the question. 


Related commands 
The following commands are related to this command: 


e COPY 

* FLDINFO 
e QUIT 

e REPORT 

- SET 

e STATUS 

e  TDUMP 

e TEMPLATE 
e TLIST 

e TMPDESC 
e UPGRADE 
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SET 


Purpose 


The Set (SET) command establishes one of the following attributes for a 
particular CDR field type: 


e DONTCARE—field captured by call processing is not required in the 
template used to format the CDR record. 


e MUSTHAVE—field is mandatory and the template used to format the 
CDR record must contain this field. 


The SET command is used when office parameter FCDR_CDR_TMPLT 
(table OFCENG) is set to VAR_TMPLT, allowing the switch to choose the 
bestfit template for the captured billing data. 


Access 
>SET 
Syntax 
>SET CDR field type MUSTHAVE | DONTCARE 
Parameters 
Command parameters are described in Table 1-70. 
Table 1-70 
SET parameter descriptions 
Parameter Values Description 
CDR field type CDR field type Indicates specific CDR field type from a predefined 
list of values. 
DONTCARE 0 = DONTCARE Specifies a CDR attribute. 
MUSTHAVE 1 = MUSTHAVE 


Example command 


Responses 


>SET CALLTYPE MUSTHAVE 


None 


Error messages 


None 
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SET (end) 


Related commands 
The following commands are related to this command: 


e COPY 

e FLDINFO 
e QUIT 

e REPORT 

e RESTORE 
e STATUS 

e TDUMP 

e TEMPLATE 
e  TLIST 

e TMPDESC 
e UPGRADE 
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Purpose 
The Status (STATUS) command displays the following information: 
e currently active template index 
e timestamp of when the index became active 
e active values for FLEXCDR office parameters 
Access 
>CTMPLT 
Syntax 
>STATUS 
Parameters 
None 


Example command 


>STATUS 
The Active version of CDRTMPLT table is: Version index = 0 
The Active CDRTMPLT table version timestamp is:1998/09/29 06:12:31.000 TUE. 
Active Edit History 
FCDR_BHR_SIZE: 60 60 60 
FCDR_GSR_SIZE: 60 60 60 
FCDR_GER_SIZE: 60 60 60 
FCDR_ESR_SIZE: 60 60 60 
FCDR_SRR_SIZE: 60 60 60 
FCDR_CCR_SIZE: 60 60 60 
FCDR_OSR_SIZE: 60 60 60 
FCDR_CDR_SIZE 
Method: FIXED_SIZE FIXED_SIZE FIXED_SIZE 
Length: 83 83 83 
FCDR_CDR_TMPLT 
Method: INTERNAL_TMPLT FIXED_TMPLT INTERNAL_TMPLT 
Template Index: ucs09 ucs09 uUCcS09 
FCDR_CDR_WORD_LAYOUT: READLR READLR READLR 
FCDR_GEN_600_LOG: N N N 
FCDR_GEN_601_LOG: N N N 


Responses 
See “Example command”. 
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STATUS (end) 


Related commands 
The following commands are related to this command: 


e COPY 

e FLDINFO 
e QUIT 

e REPORT 

e RESTORE 
e SET 

e  TDUMP 

e TEMPLATE 
e  TLIST 

e TMPDESC 
e UPGRADE 
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Purpose 


The Template Dump (TDUMP) command dumps all templates in the 
CDRTMPLT table for a particular version of the table. Selected entries are 
displayed. 


Access 

>CTMPLT 
Syntax 

>TDUMP ACTIVE | INDEX index | ALL 
Parameters 

Command parameters are described in Table 1-71. 


Table 1-71 
TDUMP parameter descriptions 
Parameter Values Description 
version ACTIVE Displays the ACTIVE VERSION to be dumped. 
VERSION index Displays the specified VERSION index to be 
range = 0 to 7 dumped. 
ALL Displays all VERSIONS of table CDRTMPLT to be 
dumped. 


Example command 


>TDUMP active 
Version(s) that will be displayed: ACTIVE 
Template Version Active Primary Index Template Size 
RESERVEDO 1 N N 0 2 
Fields 
(SEQNUM) 
Template Version Active Primary Index Template Size 
RESERVEDO1 1 N N al 2 
Fields 
(SEQNUM) 
Template Version Active Primary Index Template Size 
RESERVEDO2 1 N N 2 2 
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Fields 
(SEQNUM) 
Template Version Active Primary Index Template Size 
UCSO7 1 Y N 3 78 
Fields 
(SEQNUM) (CIC) (ORIGTIME) (ORIGDATE) (ANSTYPE) (TIMECHNG) (ORIGAMPM) 
(INCINTL) (DISCTIME) (DISCDATE) (ANISUFF) (DISCAMPM) (INCBILL) (FILL1) 
(CALLDUR) (PINDIGS) (ANISP) (INFODIG) (BILLNUM) (ACCTCD) (CLGPTYNO) 
(RLTCDR) (ACCTV) (UNIVACC) (DIALEDNO) (CALLEDNO) (OUTPULNO) (FILL4) 
(ORIGOPRT) (PREDIG) (CNPREDIG) (OPART) (TPART) (QUEUED) (RTELIST) 
(RTENO) (NETSEC) (OPCHOICE) (COLLTIME) (ADIN) (LNPCHECK) (NUMWBCKT) 
(WBCKTS) (FINSID) (BILLTYPE) (ORIGGRP) (DISCTYPE) (ORIGMEM) (PASSTHRU) 
(TERMGRP) (PRESIND) (TERMMEM) (OSRASSOC) (DIGDATA) (FINTKGRP) (TRAP) 
(COSOVE) (FINTKMEM) (SCPBILL) (TDP) (PIC) (TRIGGER) (TRTMTCD) 
(COMPCODE) (CRID) (DNIS) (ORIGPVN) (TERMPVN) (ORIGLRN) (PORTEDNO) 
(CAINCT) (ACG) (DNISNOA) (DCR) (MLTCOSID) (FILL4) (FILL1) 
(COSINDEX) (FILL2) (CARRSEL) 
Template Version Active Primary Index Template Size 
UCSO7FLEX 1 Y N 4 82 
Fields 
(SEQNUM) (CIC) (ORIGTIME) (ORIGDATE) (ANSTYPE) (TIMECHNG) (ORIGAMPM) 
(INCINTL) (DISCTIME) (DISCDATE) (ANISUFF) (DISCAMPM) (INCBILL) (FILL1) 
(CALLDUR) (PINDIGS) (ANISP) (INFODIG) (BILLNUM) (ACCTCD) (CLGPTYNO) 
(RLTCDR) (ACCTV) (UNIVACC) (DIALEDNO) (CALLEDNO) (OUTPULNO) (FILL4) 
(ORIGOPRT) (PREDIG) (CNPREDIG) (OPART) (TPART) (QUEUED) (RTELIST) 
(RTENO) (NETSEC) (OPCHOICE) (COLLTIME) (ADIN) (LNPCHECK) (NUMWBCKT) 
(WBCKTS) (FINSID) (BILLTYPE) (ORIGGRP) (DISCTYPE) (ORIGMEM) (PASSTHRU) 
(TERMGRP) (PRESIND) (TERMMEM) (OSRASSOC) (DIGDATA) (FINTKGRP) (TRAP) 
(COSOVE) (FINTKMEM) (SCPBILL) (CALLTYPE) (TRTMTCD) (COMPCODE) (CRID) 
(RELCAUSE) (DNISNOA) (DCR) (MLTCOSID) (ANSCDR) (DNIS) (FILL8) 
(COSINDEX) (REORGCTR) (OVERFLOW) (ORIGSTS) (FILL2) (CARRSEL) (STS) 
(CDRALGOR) (ACG) (ADDRNUM) (SUBRNUM1) (SUBRNUM2) (SUBRIDX1) (SUBRTYP1) 
(SUBRVAL1) (SUBRIDX2) (SUBRTYP2) (SUBRVAL2) (CLDNOA) (CLGNOA) (SUBRLOG1) 
(SUBRLOG2) (DIALNOA) (NETOPNOA) (NUMADDRS) 
Template Version Active Primary Index Template Size 
ucsO09 J Y N 6 81 
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Fields 
(SEQNUM) (CIC) (ORIGTIME) (ORIGDATE) (ANSTYPE) (TIMECHNG) (ORIGAMPM) 
(INCINTL) (DISCTIME) (DISCDATE) (ANISUFF) (DISCAMPM) (INCBILL) (FILL1) 
(CALLDUR) (PINDIGS) (ANISP) (INFODIG) (BILLNUM) (ACCTCD) (CLGPTYNO) 
(RLTCDR) (ACCTV) (UNIVACC) (DIALEDNO) (CALLEDNO) (OUTPULNO) (OUTNOA) 
(CICCASU) (CICORIGN) (ORIGOPRT) (PREDIG) (CNPREDIG) (OPART) (TPART) 
(QUEUED) (OPCHOICE) (COLLTIME) (ADIN) (LNPCHECK) (NUMWBCKT) (WBCKTS) 
(FINSID) (BILLTYPE) (ORIGGRP) (DISCTYPE) (ORIGMEM) (PASSTHRU) (TERMGRP) 
(PRESIND) (TERMMEM) (OSRASSOC) (DIGDATA) (FINTKGRP) (TRAP) (COSOVE) 
(FINTKMEM) (SCPBILL) (TRIMTCD) (COMPCODE) (CRID) (DNIS) (ORIGPVN) 
(TERMPVN) (ORIGLRN) (PORTEDNO) (CAINCT) (ACG) (DNISNOA) (DCR) 
(MLTCOSID) (FILL1) (CARRSEL) (COSINDEX) (FILL1) (RTENO) (RTEINDEX) 
(FILL2) (CN1IREQ) (CN2REQ) (CNITREQ) (NETSEC) (CN2TREQ) (CN3REQ) 


(CNTOTREQ) (CN3TREQ) (ECRN1) (ECRM1) (FILL2) (ECRN2) (ECRM2) 
(FILL2) 
Template Version Active Primary Index Template Size 
RESERVEDO7 1 N N 7 2 
Fields 
(SEQNUM) 
Template Version Active Primary Index Template Size 
RESERVEDO9 1 N N 9 2 
Fields 
(SEQNUM) 


>TDUMP VERSION 1 


Version(s) that will be displayed: INDEX 1 


Template Version Active Primary Index Template Size 
RESERVEDO LCN N00 
Fields 
gsr 
Template Version Active Primary Index Template Size 
RESERVEDOl LN Noo 
Fields 
(SEN) 
Template Version Active Primary Index Template Size 
RESERVED0O2 LN yo 200 
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Fields 
(SEQNUM) 
Template Version Active Primary Index Template Size 
UCSO7 1 Y N 3 78 
Fields 
(SEQNUM) (CIC) (ORIGTIME) (ORIGDATE) (ANSTYPE) (TIMECHNG) (ORIGAMPM) 
(INCINTL) (DISCTIME) (DISCDATE) (ANISUFF) (DISCAMPM) (INCBILL) (FILL1) 
(CALLDUR) (PINDIGS) (ANISP) (INFODIG) (BILLNUM) (ACCTCD) (CLGPTYNO) 
(RLTCDR) (ACCTV) (UNIVACC) (DIALEDNO) (CALLEDNO) (OUTPULNO) (FILL4) 
(ORIGOPRT) (PREDIG) (CNPREDIG) (OPART) (TPART) (QUEUED) (RTELIST) 
(RTENO) (NETSEC) (OPCHOICE) (COLLTIME) (ADIN) (LNPCHECK) (NUMWBCKT) 
(WBCKTS) (FINSID) (BILLTYPE) (ORIGGRP) (DISCTYPE) (ORIGMEM) (PASSTHRU) 
(TERMGRP) (PRESIND) (TERMMEM) (OSRASSOC) (DIGDATA) (FINTKGRP) (TRAP) 
(COSOVE) (FINTKMEM) (SCPBILL) (TDP) (PIC) (TRIGGER) (TRTMTCD) 
(COMPCODE) (CRID) (DNIS) (ORIGPVN) (TERMPVN) (ORIGLRN) (PORTEDNO) 
(CAINCT) (ACG) (DNISNOA) (DCR) (MLTCOSID) (FILL4) (FILL1) 
(COSINDEX) (FILL2) (CARRSEL) 
Template Version Active Primary Index Template Size 
UCSO7FLEX 1 Y N 4 82 
Fields 
(SEQNUM) (CIC) (ORIGTIME) (ORIGDATE) (ANSTYPE) (TIMECHNG) (ORIGAMPM) 
(INCINTL) (DISCTIME) (DISCDATE) (ANISUFF) (DISCAMPM) (INCBILL) (FILL1) 
(CALLDUR) (PINDIGS) (ANISP) (INFODIG) (BILLNUM) (ACCTCD) (CLGPTYNO) 
(RLTCDR) (ACCTV) (UNIVACC) (DIALEDNO) (CALLEDNO) (OUTPULNO) (FILL4) 
(ORIGOPRT) (PREDIG) (CNPREDIG) (OPART) (TPART) (QUEUED) (RTELIST) 
(RTENO) (NETSEC) (OPCHOICE) (COLLTIME) (ADIN) (LNPCHECK) (NUMWBCKT) 
(WBCKTS) (FINSID) (BILLTYPE) (ORIGGRP) (DISCTYPE) (ORIGMEM) (PASSTHRU) 
(TERMGRP) (PRESIND) (TERMMEM) (OSRASSOC) (DIGDATA) (FINTKGRP) (TRAP) 
(COSOVE) (FINTKMEM) (SCPBILL) (CALLTYPE) (TRTMTCD) (COMPCODE) (CRID) 
(RELCAUSE) (DNISNOA) (DCR) (MLTCOSID) (ANSCDR) (DNIS) (FILL8) 
(COSINDEX) (REORGCTR) (OVERFLOW) (ORIGSTS) (FILL2) (CARRSEL) (STS) 
(CDRALGOR) (ACG) (ADDRNUM) (SUBRNUM1) (SUBRNUM2) (SUBRIDX1) (SUBRTYP1) 
(SUBRVAL1) (SUBRIDX2) (SUBRTYP2) (SUBRVAL2) (CLDNOA) (CLGNOA) (SUBRLOG1) 
(SUBRLOG2) (DIALNOA) (NETOPNOA) (NUMADDRS) 
Template Version Active Primary Index Template Size 
ucso9 1 x N 6 81 
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1-290 Commands 


CTMPLT commands 
TDUMP (continued) 


Fields 
(SEQNUM) (CIC) (ORIGTIME) (ORIGDATE) (ANSTYPE) (TIMECHNG) (ORIGAMPM) 
(INCINTL) (DISCTIME) (DISCDATE) (ANISUFF) (DISCAMPM) (INCBILL) (FILL1) 
(CALLDUR) (PINDIGS) (ANISP) (INFODIG) (BILLNUM) (ACCTCD) (CLGPTYNO) 
(RLTCDR) (ACCTV) (UNIVACC) (DIALEDNO) (CALLEDNO) (OUTPULNO) (OUTNOA) 
(CICCASU) (CICORIGN) (ORIGOPRT) (PREDIG) (CNPREDIG) (OPART) (TPART) 
(QUEUED) (OPCHOICE) (COLLTIME) (ADIN) (LNPCHECK) (NUMWBCKT) (WBCKTS) 
(FINSID) (BILLTYPE) (ORIGGRP) (DISCTYPE) (ORIGMEM) (PASSTHRU) (TERMGRP) 
(PRESIND) (TERMMEM) (OSRASSOC) (DIGDATA) (FINTKGRP) (TRAP) (COSOVE) 
(FINTKMEM) (SCPBILL) (TRIMTCD) (COMPCODE) (CRID) (DNIS) (ORIGPVN) 
(TERMPVN) (ORIGLRN) (PORTEDNO) (CAINCT) (ACG) (DNISNOA) (DCR) 
(MLTCOSID) (FILL1) (CARRSEL) (COSINDEX) (FILL1) (RTENO) (RTEINDEX) 
(FILL2) (CN1IREQ) (CN2REQ) (CNITREQ) (NETSEC) (CN2TREQ) (CN3REQ) 


(CNTOTREQ) (CN3TREQ) (ECRN1) (ECRM1) (FILL2) (ECRN2) (ECRM2) 
(FILL2) 
Template Version Active Primary Index Template Size 
RESERVEDO7 1 N N 7 2 
Fields 
(SEQNUM) 
Template Version Active Primary Index Template Size 
RESERVEDO9 1 N N 9 2 
Fields 
(SEQNUM) 
>TDUMP ALL 
Version(s) that will be displayed: ALL 
Template Version Active Primary Index Template Size 
RESERVEDO 0 N N 0 2 
Fields 
(SEQNUM) 
Template Version Active Primary Index Template Size 
RESERVEDO1 0 N N 1 2 
Fields 
(SEQNUM) 
Template Version Active Primary Index Template Size 
RESERVEDO2 0 N N 2 2 
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Commands 1-291 


CTMPLT commands 
TDUMP (continued) 


Fields 
(SEQNUM) 
Template Version Active Primary Index Template Size 
UCSO7 0 Y N 3 78 
Fields 
(SEQNUM) (CIC) (ORIGTIME) (ORIGDATE) (ANSTYPE) (TIMECHNG) (ORIGAMPM) 
(INCINTL) (DISCTIME) (DISCDATE) (ANISUFF) (DISCAMPM) (INCBILL) (FILL1) 
(CALLDUR) (PINDIGS) (ANISP) (INFODIG) (BILLNUM) (ACCTCD) (CLGPTYNO) 
(RLTCDR) (ACCTV) (UNIVACC) (DIALEDNO) (CALLEDNO) (OUTPULNO) (FILL4) 
(ORIGOPRT) (PREDIG) (CNPREDIG) (OPART) (TPART) (QUEUED) (RTELIST) 
(RTENO) (NETSEC) (OPCHOICE) (COLLTIME) (ADIN) (LNPCHECK) (NUMWBCKT) 
(WBCKTS) (FINSID) (BILLTYPE) (ORIGGRP) (DISCTYPE) (ORIGMEM) (PASSTHRU) 
(TERMGRP) (PRESIND) (TERMMEM) (OSRASSOC) (DIGDATA) (FINTKGRP) (TRAP) 
(COSOVE) (FINTKMEM) (SCPBILL) (TDP) (PIC) (TRIGGER) (TRTMTCD) 
(COMPCODE) (CRID) (DNIS) (ORIGPVN) (TERMPVN) (ORIGLRN) (PORTEDNO) 
(CAINCT) (ACG) (DNISNOA) (DCR) (MLTCOSID) (FILL4) (FILL1) 
(COSINDEX) (FILL2) (CARRSEL) 
Template Version Active Primary Index Template Size 
UCSO7FLEX 0 Y N 4 82 
Fields 
(SEQNUM) (CIC) (ORIGTIME) (ORIGDATE) (ANSTYPE) (TIMECHNG) (ORIGAMPM) 
(INCINTL) (DISCTIME) (DISCDATE) (ANISUFF) (DISCAMPM) (INCBILL) (FILL1) 
(CALLDUR) (PINDIGS) (ANISP) (INFODIG) (BILLNUM) (ACCTCD) (CLGPTYNO) 
(RLTCDR) (ACCTV) (UNIVACC) (DIALEDNO) (CALLEDNO) (OUTPULNO) (FILL4) 
(ORIGOPRT) (PREDIG) (CNPREDIG) (OPART) (TPART) (QUEUED) (RTELIST) 
(RTENO) (NETSEC) (OPCHOICE) (COLLTIME) (ADIN) (LNPCHECK) (NUMWBCKT) 
(WBCKTS) (FINSID) (BILLTYPE) (ORIGGRP) (DISCTYPE) (ORIGMEM) (PASSTHRU) 
(TERMGRP) (PRESIND) (TERMMEM) (OSRASSOC) (DIGDATA) (FINTKGRP) (TRAP) 
(COSOVE) (FINTKMEM) (SCPBILL) (CALLTYPE) (TRTMTCD) (COMPCODE) (CRID) 
(RELCAUSE) (DNISNOA) (DCR) (MLTCOSID) (ANSCDR) (DNIS) (FILL8) 
(COSINDEX) (REORGCTR) (OVERFLOW) (ORIGSTS) (FILL2) (CARRSEL) (STS) 
(CDRALGOR) (ACG) (ADDRNUM) (SUBRNUM1) (SUBRNUM2) (SUBRIDX1) (SUBRTYP1) 
(SUBRVAL1) (SUBRIDX2) (SUBRTYP2) (SUBRVAL2) (CLDNOA) (CLGNOA) (SUBRLOG1) 
(SUBRLOG2) (DIALNOA) (NETOPNOA) (NUMADDRS) 
Template Version Active Primary Index Template Size 
ucso9 0 y N 6 81 
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1-292 Commands 


CTMPLT commands 
TDUMP (continued) 


Fields 
(SEQNUM) (CIC) (ORIGTIME) (ORIGDATE) (ANSTYPE) (TIMECHNG) (ORIGAMPM) 
(INCINTL) (DISCTIME) (DISCDATE) (ANISUFF) (DISCAMPM) (INCBILL) (FILL1) 
(CALLDUR) (PINDIGS) (ANISP) (INFODIG) (BILLNUM) (ACCTCD) (CLGPTYNO) 
(RLTCDR) (ACCTV) (UNIVACC) (DIALEDNO) (CALLEDNO) (OUTPULNO) (OUTNOA) 
(CICCASU) (CICORIGN) (ORIGOPRT) (PREDIG) (CNPREDIG) (OPART) (TPART) 
(QUEUED) (OPCHOICE) (COLLTIME) (ADIN) (LNPCHECK) (NUMWBCKT) (WBCKTS) 
(FINSID) (BILLTYPE) (ORIGGRP) (DISCTYPE) (ORIGMEM) (PASSTHRU) (TERMGRP) 
(PRESIND) (TERMMEM) (OSRASSOC) (DIGDATA) (FINTKGRP) (TRAP) (COSOVE) 
(FINTKMEM) (SCPBILL) (TRIMTCD) (COMPCODE) (CRID) (DNIS) (ORIGPVN) 
(TERMPVN) (ORIGLRN) (PORTEDNO) (CAINCT) (ACG) (DNISNOA) (DCR) 
(MLTCOSID) (FILL1) (CARRSEL) (COSINDEX) (FILL1) (RTENO) (RTEINDEX) 
(FILL2) (CN1IREQ) (CN2REQ) (CNITREQ) (NETSEC) (CN2TREQ) (CN3REQ) 


(CNTOTREQ) (CN3TREQ) (ECRN1) (ECRM1) (FILL2) (ECRN2) (ECRM2) 
(FILL2) 
Template Version Active Primary Index Template Size 
RESERVEDO7 0) N N 7 2 
Fields 
(SEQNUM) 
Template Version Active Primary Index Template Size 
RESERVEDO9 0 N N 9 2 
Fields 
(SEQNUM) 
Template Version Active Primary Index Template Size 
RESERVEDO 1 N N 0 2 
Fields 
(SEQNUM) 
Template Version Active Primary Index Template Size 
RESERVED01 1 N N 1 2 
Fields 
(SEQNUM) 
Template Version Active Primary Index Template Size 
RESERVED02 1 N N 2 2 
Fields 
(SEQNUM) 
Template Version Active Primary Index Template Size 
UCSO7 1 Y N 3 78 
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Commands 1-293 


CTMPLT commands 
TDUMP (continued) 


Fields 

(SEQNUM) (CIC) (ORIGTIME) (ORIGDATE) (ANSTYPE) (TIMECHNG) (ORIGAMPM) 
(INCINTL) (DISCTIME) (DISCDATE) (ANISUFF) (DISCAMPM) (INCBILL) (FILL1) 
(CALLDUR) (PINDIGS) (ANISP) (INFODIG) (BILLNUM) (ACCTCD) (CLGPTYNO) 
(RLTCDR) (ACCTV) (UNIVACC) (DIALEDNO) (CALLEDNO) (OUTPULNO) (FILL4) 
(ORIGOPRT) (PREDIG) (CNPREDIG) (OPART) (TPART) (QUEUED) (RTELIST) 
(RTENO) (NETSEC) (OPCHOICE) (COLLTIME) (ADIN) (LNPCHECK) (NUMWBCKT) 
(WBCKTS) (FINSID) (BILLTYPE) (ORIGGRP) (DISCTYPE) (ORIGMEM) (PASSTHRU) 
(TERMGRP) (PRESIND) (TERMMEM) (OSRASSOC) (DIGDATA) (FINTKGRP) (TRAP) 
(COSOVE) (FINTKMEM) (SCPBILL) (TDP) (PIC) (TRIGGER) (TRTMTCD) 
(COMPCODE) (CRID) (DNIS) (ORIGPVN) (TERMPVN) (ORIGLRN) (PORTEDNO) 
(CAINCT) (ACG) (DNISNOA) (DCR) (MLTCOSID) (FILL4) (FILL1) 
(COSINDEX) (FILL2) (CARRSEL) 

Template Version Active Primary Index Template Size 
UCSO7FLEX 1 Y N 4 82 

Fields 

(SEQNUM) (CIC) (ORIGTIME) (ORIGDATE) (ANSTYPE) (TIMECHNG) (ORIGAMPM) 
(INCINTL) (DISCTIME) (DISCDATE) (ANISUFF) (DISCAMPM) (INCBILL) (FILL1) 
(CALLDUR) (PINDIGS) (ANISP) (INFODIG) (BILLNUM) (ACCTCD) (CLGPTYNO) 
(RLTCDR) (ACCTV) (UNIVACC) (DIALEDNO) (CALLEDNO) (OUTPULNO) (FILL4) 
(ORIGOPRT) (PREDIG) (CNPREDIG) (OPART) (TPART) (QUEUED) (RTELIST) 
(RTENO) (NETSEC) (OPCHOICE) (COLLTIME) (ADIN) (LNPCHECK) (NUMWBCKT) 
(WBCKTS) (FINSID) (BILLTYPE) (ORIGGRP) (DISCTYPE) (ORIGMEM) (PASSTHRU) 
(TERMGRP) (PRESIND) (TERMMEM) (OSRASSOC) (DIGDATA) (FINTKGRP) (TRAP) 
(COSOVE) (FINTKMEM) (SCPBILL) (CALLTYPE) (TRTMTCD) (COMPCODE) (CRID) 
(RELCAUSE) (DNISNOA) (DCR) (MLTCOSID) (ANSCDR) (DNIS) (FILL8) 
(COSINDEX) (REORGCTR) (OVERFLOW) (ORIGSTS) (FILL2) (CARRSEL) (STS) 
(CDRALGOR) (ACG) (ADDRNUM) (SUBRNUM1) (SUBRNUM2) (SUBRIDX1) (SUBRTYP1) 
(SUBRVAL1) (SUBRIDX2) (SUBRTYP2) (SUBRVAL2) (CLDNOA) (CLGNOA) (SUBRLOG1) 
(SUBRLOG2) (DIALNOA) (NETOPNOA) (NUMADDRS) 

Template Version Active Primary Index Template Size 
uUCcSO9 1 Y N 6 81 
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1-294 Commands 


CTMPLT commands 
TDUMP (continued) 


Fields 
(SEQNUM) (CIC) (ORIGTIME) (ORIGDATE) (ANSTYPE) (TIMECHNG) (ORIGAMPM) 
(INCINTL) (DISCTIME) (DISCDATE) (ANISUFF) (DISCAMPM) (INCBILL) (FILL1) 
(CALLDUR) (PINDIGS) (ANISP) (INFODIG) (BILLNUM) (ACCTCD) (CLGPTYNO) 
(RLTCDR) (ACCTV) (UNIVACC) (DIALEDNO) (CALLEDNO) (OUTPULNO) (OUTNOA) 
(CICCASU) (CICORIGN) (ORIGOPRT) (PREDIG) (CNPREDIG) (OPART) (TPART) 
(QUEUED) (OPCHOICE) (COLLTIME) (ADIN) (LNPCHECK) (NUMWBCKT) (WBCKTS) 
(FINSID) (BILLTYPE) (ORIGGRP) (DISCTYPE) (ORIGMEM) (PASSTHRU) (TERMGRP) 
(PRESIND) (TERMMEM) (OSRASSOC) (DIGDATA) (FINTKGRP) (TRAP) (COSOVE) 
(FINTKMEM) (SCPBILL) (TRIMTCD) (COMPCODE) (CRID) (DNIS) (ORIGPVN) 
(TERMPVN) (ORIGLRN) (PORTEDNO) (CAINCT) (ACG) (DNISNOA) (DCR) 
(MLTCOSID) (FILL1) (CARRSEL) (COSINDEX) (FILL1) (RTENO) (RTEINDEX) 
(FILL2) (CN1IREQ) (CN2REQ) (CNITREQ) (NETSEC) (CN2TREQ) (CN3REQ) 


(CNTOTREQ) (CN3TREQ) (ECRN1) (ECRM1) (FILL2) (ECRN2) (ECRM2) 
(FILL2) 
Template Version Active Primary Index Template Size 
RESERVEDO7 1 N N 7 2 
Fields 
(SEQNUM) 
Template Version Active Primary Index Template Size 
RESERVEDO9 1 N N 9 2 
Fields 
(SEQNUM) 
Template Version Active Primary Index Template Size 
RESERVEDO1 2 N N 1 2 
Fields 
(SEQNUM) 
Template Version Active Primary Index Template Size 
RESERVEDO2 2 N N 2 2 
Fields 
(SEQNUM) 
Template Version Active Primary Index Template Size 
UCSO7 2 Y N 3 78 
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Commands 1-295 


CTMPLT commands 
TDUMP (continued) 


Fields 

(SEQNUM) (CIC) (ORIGTIME) (ORIGDATE) (ANSTYPE) (TIMECHNG) (ORIGAMPM) 
(INCINTL) (DISCTIME) (DISCDATE) (ANISUFF) (DISCAMPM) (INCBILL) (FILL1) 
(CALLDUR) (PINDIGS) (ANISP) (INFODIG) (BILLNUM) (ACCTCD) (CLGPTYNO) 
(RLTCDR) (ACCTV) (UNIVACC) (DIALEDNO) (CALLEDNO) (OUTPULNO) (FILL4) 
(ORIGOPRT) (PREDIG) (CNPREDIG) (OPART) (TPART) (QUEUED) (RTELIST) 
(RTENO) (NETSEC) (OPCHOICE) (COLLTIME) (ADIN) (LNPCHECK) (NUMWBCKT) 
(WBCKTS) (FINSID) (BILLTYPE) (ORIGGRP) (DISCTYPE) (ORIGMEM) (PASSTHRU) 
(TERMGRP) (PRESIND) (TERMMEM) (OSRASSOC) (DIGDATA) (FINTKGRP) (TRAP) 
(COSOVE) (FINTKMEM) (SCPBILL) (TDP) (PIC) (TRIGGER) (TRTMTCD) 
(COMPCODE) (CRID) (DNIS) (ORIGPVN) (TERMPVN) (ORIGLRN) (PORTEDNO) 
(CAINCT) (ACG) (DNISNOA) (DCR) (MLTCOSID) (FILL4) (FILL1) 
(COSINDEX) (FILL2) (CARRSEL) 

Template Version Active Primary Index Template Size 
UCSO7FLEX 2 Y N 4 82 

Fields 

(SEQNUM) (CIC) (ORIGTIME) (ORIGDATE) (ANSTYPE) (TIMECHNG) (ORIGAMPM) 
(INCINTL) (DISCTIME) (DISCDATE) (ANISUFF) (DISCAMPM) (INCBILL) (FILL1) 
(CALLDUR) (PINDIGS) (ANISP) (INFODIG) (BILLNUM) (ACCTCD) (CLGPTYNO) 
(RLTCDR) (ACCTV) (UNIVACC) (DIALEDNO) (CALLEDNO) (OUTPULNO) (FILL4) 
(ORIGOPRT) (PREDIG) (CNPREDIG) (OPART) (TPART) (QUEUED) (RTELIST) 
(RTENO) (NETSEC) (OPCHOICE) (COLLTIME) (ADIN) (LNPCHECK) (NUMWBCKT) 
(WBCKTS) (FINSID) (BILLTYPE) (ORIGGRP) (DISCTYPE) (ORIGMEM) (PASSTHRU) 
(TERMGRP) (PRESIND) (TERMMEM) (OSRASSOC) (DIGDATA) (FINTKGRP) (TRAP) 
(COSOVE) (FINTKMEM) (SCPBILL) (CALLTYPE) (TRTMTCD) (COMPCODE) (CRID) 
(RELCAUSE) (DNISNOA) (DCR) (MLTCOSID) (ANSCDR) (DNIS) (FILL8) 
(COSINDEX) (REORGCTR) (OVERFLOW) (ORIGSTS) (FILL2) (CARRSEL) (STS) 
(CDRALGOR) (ACG) (ADDRNUM) (SUBRNUM1) (SUBRNUM2) (SUBRIDX1) (SUBRTYP1) 
(SUBRVAL1) (SUBRIDX2) (SUBRTYP2) (SUBRVAL2) (CLDNOA) (CLGNOA) (SUBRLOG1) 
(SUBRLOG2) (DIALNOA) (NETOPNOA) (NUMADDRS) 

Template Version Active Primary Index Template Size 
uUCcSO9 2 Y N 6 81 
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1-296 Commands 


CTMPLT commands 
TDUMP (continued) 


Fields 

(SEQNUM) (CIC) (ORIGTIME) (ORIGDATE) (ANSTYPE) (TIMECHNG) (ORIGAMPM) 
(INCINTL) (DISCTIME) (DISCDATE) (ANISUFF) (DISCAMPM) (INCBILL) (FILL1) 
(CALLDUR) (PINDIGS) (ANISP) (INFODIG) (BILLNUM) (ACCTCD) (CLGPTYNO) 
(RLTCDR) (ACCTV) (UNIVACC) (DIALEDNO) (CALLEDNO) (OUTPULNO) (OUTNOA) 
(CICCASU) (CICORIGN) (ORIGOPRT) (PREDIG) (CNPREDIG) (OPART) (TPART) 
(QUEUED) (OPCHOICE) (COLLTIME) (ADIN) (LNPCHECK) (NUMWBCKT) (WBCKTS) 
(FINSID) (BILLTYPE) (ORIGGRP) (DISCTYPE) (ORIGMEM) (PASSTHRU) (TERMGRP) 
(PRESIND) (TERMMEM) (OSRASSOC) (DIGDATA) (FINTKGRP) (TRAP) (COSOVE) 
(FINTKMEM) (SCPBILL) (TRIMTCD) (COMPCODE) (CRID) (DNIS) (ORIGPVN) 


(TERMPVN) (ORIGLRN) (PORTEDNO) (CAINCT) (ACG) (DNISNOA) (DCR) 
(MLTCOSID) (FILL1) (CARRSEL) (COSINDEX) (FILL1) (RTENO) (RTEINDEX) 
(FILL2) (CNIREQ) (CN2REQ) (CNITREQ) (NETSEC) (CN2TREQ) (CN3REQ) 
(CNTOTREQ) (CN3TREQ) (ECRN1) (ECRM1) (FILL2) (ECRN2) (ECRM2) 
(FILL2) 
Template Version Active Primary Index Template Size 
RESERVEDO7 2 N N T 2 
Fields 
(SEQNUM) 
Template Version Active Primary Index Template Size 
RESERVED09 2 N N 9 2 
Fields 
(SEQNUM) 
Responses 
None 


Related commands 
The following commands are related to this command: 


e COPY 

e FLDINFO 

e QUIT 

e REPORT 

e RESTORE 

e SET 

e STATUS 

e TEMPLATE 
e TLIST 
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CTMPLT commands 
TDUMP (end) 


e TMPDESC 
e UPGRADE 
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1-298 Commands 


CTMPLT commands 
TEMPLATE 


Purpose 
The Template (TEMPLATE) command displays all the templates defined in 
the CDRTMPLT table. It lists the template key index and the associated 
template ten-string name. The index value is stored in the CDR record as the 
TEMPLID field that is sent to the downstream processor. 


This command allows the telco to list all of the available templates so that 
the downstream processor can be kept in synch with the UCS DMS-250 


switch. 
Access 

>CTMPLT 
Syntax 

>TEMPLATE template_id | ALL 
Parameters 


The Template name is UCS12 (for example), the name of the template as it 
appears in table CDRTMPLIT. The template_id is 0 to 63; the first 10 
templates are predefined. 


Example command 
The list of indices and defined templates is as follows: 


>TEMPLATE ALL 


0: CDR2AMA 

1: RESERVEDO1 
2: RESERVEDO2 
3: UCSO7 

4: UCSO7FLEX 
5: RESERVEDO5 
6 
7 
8 
9 


: ucs09 
: UCS11 
+ UCST2 
: RESERVEDO9 


Responses 
None 
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CTMPLT commands 
TEMPLATE (end) 


Related commands 
The following commands are related to this command: 


e COPY 

e FLDINFO 
e QUIT 

e REPORT 

e RESTORE 
e SET 

e STATUS 

e TDUMP 

e  TLIST 

e TMPDESC 
e UPGRADE 
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1-300 Commands 


CTMPLT commands 


TLIST 


Purpose 


The Template List (TLIST) command lists all or specified versions of a 
specified template entry in the CDRTMPLT table. Selected entries are 
displayed; printing options do not exist. 


Access 


>CTMPLT 


Syntax 


>TLIST Template ID ACTIVE | VERSION index | ALL 


Parameters 


Command parameters are described in Table 1-72. 


Table 1-72 


TLIST parameter descriptions 


Parameter Values Description 
Template ID 1 to 16 Indicates a defined template ID string. 
alphanumeric 
characters 
VERSION ACTIVE | VERSION Indicates which index is used to list for the specified 
selection | ALL template ID. 
Index value digits Specifies the version index to list. 
(0 to 7) 


Example command 
>TLIST UCSO9_CDR VERSION 0 


The example illustrates the fields that display when the following values are 
entered: 


Key = UCSO9_CDR 
Active = Y 

Primary = N 
Template ID = 6 


Template Size = 83 words 
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CTMPLT commands 
TLIST (continued) 


Example command 


Responses 


>TLIST UCSO9 ACTIVE 


UCSO9 Index value: 6 
that will be displayed: ACTIVE 


Template: 
Version (s) 


Template Version Active Primary Index Template Size 

UCcS09 0 Y N 6 81 
Fields 

(SEQNUM) (CIC) (ORIGTIME) (ORIGDATE) (ANSTYPE) (TIMECHNG) (ORIGAMPM) 
(INCINTL) (DISCTIME) (DISCDATE) (ANISUFF) (DISCAMPM) (INCBILL) (FILLI) 
(CALLDUR) (PINDIGS) (ANISP) (INFODIG) (BILLNUM) (ACCTCD) (CLGPTYNO) 
(RLTCDR) (ACCTV) (UNIVACC) (DIALEDNO) (CALLEDNO) (OUTPULNO) (OUTNOA) 
(CICCASU) (CICORIGN) (ORIGOPRT) (PREDIG) (CNPREDIG) (OPART) (TPART) 
(QUEUED) (OPCHOICE) (COLLTIME) (ADIN) (LNPCHECK) (NUMWBCKT) (WBCKTS) 
(FINSID) (BILLTYPE) (ORIGGRP) (DISCTYPE) (ORIGMEM) (PASSTHRU) (TERMGRP) 
(PRESIND) (TERMMEM) (OSRASSOC) (DIGDATA) (FINTKGRP) (TRAP) (COSOVE) 
(FINTKMEM) (SCPBILL) (TRTMTCD) (COMPCODE) (CRID) (DNIS) (ORIGPVN) (TERMPVN) 
(ORIGLRN) (PORTEDNO) (CAINCT) (ACG) (DNISNOA) (DCR) (MLTCOSID) (FILL1) 
(CARRSEL) (COSINDEX) (FILL1) (RTENO) (RTEINDEX) (FILL2) (CN1REQ) (CN2REQ) 
(CN1TREQ) (NETSEC) (CN2TREQ) (CN3REQ) (CNTOTREQ) (CN3TREQ) (ECRN1) (ECRM1) 
(FILL2) (ECRN2) (ECRM2) (FILL2) 


> 
>template UCS09 


Template: UCSO9 Index value: 6 


None 


Related commands 


The following commands are related to this command: 


e COPY 

e FLDINFO 

e QUIT 

e REPORT 

e RESTORE 

- SET 

e STATUS 

e  TDUMP 

e TEMPLATE 
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TLIST (end) 


e TMPDESC 
e UPGRADE 
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TMPDESC 


Purpose 


Access 


Syntax 


Parameters 


The Template Description (TMPDESC) command displays a description of 
a template in table CDRTMPLT for a particular numeric index. The entry 
displays field names, size, offset within a word, and the word count. 


>CTMPLT 


>TMPDESC <template> <version> [word layout] [cdr size] 


Table 1-73 describes the TMPDESC parameters. 


Table 1-73 
TMPDESC parameter descriptions 
Parameter Values Description 
template valid name Enter a template name. 
from table 
CDRTMPLT 
version ACTIVE, Enter ACTIVE to view the version of the 
VERSION template available to format CDR’s. Every 
index or ALL active template is output on the screen. Enter 
VERSION and the index parameter to view a 
particular version of the CDR template. Enter 
ALL to view all versions of every template. 
index O0to7 Enter the version of the CDR template 
required. 
word layout NORMAL, NORMAL indicates that fields are placed in 
or READLR the CDR in a right-to-left order. READLR 
indicates that fields are placed in the CDR in 
a left-to-right order. 
cdr size FIXED-SIZE — FIXED-SIZE indicates the size of the CDR is 
or always a set length, irregardless of the 
VAR-SIZE template used. VAR-SIZE indicates the size 
of the CDR is determined based on the 
template used. 
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TMPDESC (continued) 


Example command 


>TMPDESC ucs09 active 


Template: UCSO9 Index value: 6 
Version(s) that will be displayed: ACTIVE 
This Template is displayed in READLR Layout. 


This Template is displayed with FIXED_SIZE Option. 


Template Version Active Primary Index Template Size 
ucsO09 0 Y N 6 81 
Field Field Size Offset Word 
RECCD 16 15 0 
VARLENGTH 1 L5 
RESERVED1 3 L4 
USEEDIT 1 1i 
TOOLGEN 1 10 
ACTIDX 3 9 1 
TEMPLID 7 6 1 
SEQNUM 16 5 2 
CLC 16 15 3 
ORIGTIME 16 5 4 
ORIGDATE 9 5 5 
ANSTYPE 4 6 5 
TIMECHNG 1 2 5 
ORIGAMPM 1 1 5 
INCINTL 1 0 5 
DISCTIME 16 5 6 
DISCDATE 9 5 7 
ANISUFF 3 6 7 
DISCAMPM 1 3 z 
INCBILL 2 2 fi 
FILL1 T 0 7 
CALLDUR 32 15 8 
PINDIGS 16 15 10 
ANISP 40 15 TI 
INFODIG 8 7 13 
BILLNUM 96 5 14 
ACCTCD 48 5 20 
CLGPTYNO 60 5 23 
RLTCDR 2 3 26 
ACCTV 2 26 
UNIVACC 40 5 27 
DIALEDNO 60 7 29 
CALLEDNO 60 1 33 
OUTPULNO 60 37 
OUTNOA 1 3 40 
CICASU 1 2 40 
CICORIGN 2 1 40 
ORIGOPRT 10 15 41 
PREDIG 3 5 41 
CNPREDIG 3 2 41 
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TMPDESC (continued) 


OPART 10 iS 42 
TPART 5 5 42 
QUEUED 1 0 42 
OPCHOICE 8 5 43 
COLLT IME 8 7 43 
ADIN 8 15 44 
LNPCHECK 3 7 44 
NUMWBCKT 5 4 44 
WBCKTS 32 5 45 
FINSID 10 5 47 
BILLTYPE 6 5 47 
ORIGGRP 14 5 48 
DISCTYPE 2 1 48 
ORIGMEM 14 15 49 
PASSTHRU 2 1 49 
TERMGRP 14 15 50 
PRESIND 2 J 50 
TERMMEM 14 5 51 
OSRASSOC 1 51 
DIGDATA 1 0 51 
FINTKGRP 14 5 52 
TRAP 1 Al 52 
COSOVE 1 0 52 
FINTKMEM 16 5 53 
SCPBILL 32 5 54 
TRIMTCD 8 5 56 
COMPCODE 4 a 56 
CRID 36 3 56 
DNIS 60 15 59 
ORIGPVN 60 3 62 
TERMPVN 60 7 66 
ORIGLRN 40 11 70 
PORTEDNO 40 3 72 
CAINCT 3 11 15 
ACG 1 75 
DNISNOA 7 7 T5 
DCR 1 0 75 
MLTCOSID ITI I5 76 
FILL1 1 4 76 
CARRSEL 4 3 76 
COSINDEX 10 15 77 
FILL1 al 5 TE 
RTENO 5 4 77 
RTEINDEX 14 15 78 
FILL2 2 1 78 
CN1REQ 6 15 79 
CN2REQ 6 9 79 
CN1TREQ 3 79 
NETSEC 1 719 
CN2TREQ 3 15 80 
CN3REQ 6 12 80 
CNTOTREQ 4 6 80 
CN3TREQ 3 2 80 
ECRN1 9 15 81 
ECRM1 5 6 81 
FILL2 2 I 81 
ECRN2 9 15 82 
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TMPDESC (end) 
ECRM2 ia) 6 82 
FILL2 2 L 82 
Responses 
None 


Related commands 
The following commands are related to this command: 


e COPY 

e FLDINFO 
e QUIT 

e REPORT 

e RESTORE 
e SET 

e STATUS 

e TDUMP 

e TEMPLATE 
e TLIST 

e UPGRADE 
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UPGRADE 


Purpose 


Access 


The Upgrade (UPGRADE) command increments the active version index of 
table CDRTMPLT to change the set of templates to use for formatting CDR 
records. The UPGRADE command performs the following: 


e verifies at least one active template is available for use in the editing 
version of table CDRTMPLT 


e verifies an index being “turned off’ or removed is not referenced by the 
CDRTMPLT option of other tables or by the FCDR_CDR_TMPLT 
office parameter 


e checks the state of SOC UBFROO01 

e prompts the user to confirm the actual upgrade change 

e writes the timestamp of the newly active version of table CDRTMPLT 
* copies edited templates to edited index +1, if SOC is on 

e increments the active and editing indexes, if SOC is on 


e initiates a DIRP file and/or FP billing server file rotation (rotates all open 
billings files: active or inactive, CM or FP) 


The UPGRADE command is blocked during the following conditions when 
the Supernode Data Manager (SDM) is connected to the switch. Suitable 
warning messages display through the CTMPLT command. 


e Ifthe CDR data stream on the SDM is not in service, off-line, or in a 
recovery state, the UPGRADE command is canceled. (The updates to 
FLEXCDR data are only allowed when the CDR stream is in required 
valid state.) 


e Ifthe CDR stream is in recovery and the maximum upgrades (6) allowed 
during recovery have been reached, the UPGRADE is canceled. 


Note: You are allowed to change, edit, or delete any tuples from a table. 
The table control is not restricted. The only restriction is the number of 
UPGRADES you can perform while in recovery (RECV) mode, which is 
limited to six. 


e When the UPGRADE template is sent from the Computing Module 


(CM) to SDM, and the communication btween CM and SDM fails, CM 
is not updated. The UPGRADE command is canceled. 


>CTMPLT 
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UPGRADE (continued) 


Syntax 
>UPGRADE 


Parameters 
None 


Example command 
>UPGRADE 


Responses 


The following responses may display as a result of the UPGRADE 
command: 


Another table references a tuple that has either been deleted 
or made inactive. Therefore, this upgrade is denied. 


Explanation: 

A table has a reference to a Template ID that is inactive or deleted. 
Other tables that may be cited here include RTEATTR, 
AUTHCODU, AUTHCDUx (x=2-5), TRKFEAT, FLEXFEAT, 
STDPRTCT, FLEXTYPE, and ANISCUSP. Therefore, the upgrade is 
denied. 


System action: 
Denies the upgrade. 


User action: 
None 


Are you sure (Y/N): 
Explanation: 
Confirmation of the UPGRADE is accepted. 


System action: 
If confirmed, carry out the upgrade. 


User action: 
Enter Y or N in response to the question. 
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UPGRADE (end) 


Related commands 
The following commands are related to this command: 


e COPY 

e FLDINFO 
e QUIT 

e REPORT 

e RESTORE 
e SET 

e STATUS 

e TDUMP 

e TEMPLATE 
e  TLIST 

e TMPDESC 
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DRM (end) 

Purpose 
The Distributed Record Manager (DRM) command allows entry into the 
DRM directory and provides access to its commands. DRM-based 
commands perform control and review functions for a distributed recording 
manager. 

Access 


>MAPCI;MTC;APPL;OAMAP;DRM 
Related commands 

The following commands are accessible in the DRM directory: 

e AUDIT 

e DAT 

e COPY 

e DEMOUNT 

e INFO 

e MONITOR 

e MOUNT 

e QUIT 

e RENAME 

e RESET 

e ROTATE 

e TCOPY 

e VIEW 
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AUDIT 


Purpose 


Access 
Syntax 


Parameters 


Table 1-74 


The Audit (AUDIT) command requests a comprehensive review of an 
application and its resources. The following types of audit are performed: 


e application 


e space 
e volume 
>DRM 


>AUDIT stream audit_type destnode 


Command parameters are described in Table 1-74. 


AUDIT parameter descriptions 


Parameter Values Description 
stream OCC Specifies the pre-defined call data stream name for 
(applid) the UCS DMS-250 switch. 

Note: OCC designates a UCS DMS-250 switch. 
audit_type Valid values include: 


ALL Performs all audit types. 
APPL Updates the application on the selected node. 
FDIR Verifies that the contents of the local DRMFDIR 


match the contents of the local volume. 


Note: Files are deleted/added to the DRMFDIR to 
match the actual contents of the volume. 


REC Captures recording measurements. 


—continued— 
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AUDIT (continued) 


Table 1-74 
AUDIT parameter descriptions (continued) 


Parameter Values 


Description 


SPACE 


VOL 


destnode string 
(optional 
parameter) 


act 


node_nn 


Updates space data for all in-service volumes and 
includes: 


e deleting processed (P) files (as needed) 
e  raising/clearing space alarms (as needed) 


e updating the rotate data used for prioritizing the 
selection of the next rotation volume 


Updates the status of specified volumes. 
Note: |f the volume status changes, a SPACE audit 
is performed. Selection of VOL requires the entry of 


a volume name or number; all volumes in table 
DRMPOOL may also be selected. 


Indicates the audit target. 


Note: |f no value is entered, the stream’s active 
node is selected by default. 


Default value that replaces a node name variable to 
refer to the application’s active device. 


Note: This value is automatically selected when 
“node_nn” is specified. 


Indicates the value assigned to audited node. 


—end— 


Example command 
>AUDIT occ appl fp0 


297-2621-819 Standard 14.01 April 2002 


Commands 1-313 


DRM commands 


Responses 


AUDIT (continued) 
AUDIT OCC APPL Completed on FPO. 
---- Counts from 97/01/12 20.04.13 ==== 
---ERROR CONDITIONS--- REQUEST PEND 
STATUS TBL SPA REQ FER VER SWE RTR ROT AUD 
ACTIVE i ob 2 0 & Q o a ï 
Explanation: 
The operation was successful, and the counts displayed were last 
reset to zero on the date and time given. 
User action: 
None 
AUDIT OCC FDIR Completed on FPO 
Inmsy Number of £1168 ei oss ced oe Bee be wees eas 37 
AGEIVE: ELLES. berg: seda ea ana a erect a a 1 
Unprocessed fileS...... eee ee ee ee ee eseo 34 
Processed file cees ise couse: aaia a a a 11 
Removed “FUMES ae sese Seed abies: ences ee eee: a ra 0 
Explanation: 


The operation was successful. File counts from the DRM directory 
maintained on FPO are displayed. 


User action: 
None 
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AUDIT (continued) 


AUDIT 


REC 
AUDIT 


AUDIT 


OCC REC Completed on FPO. 


Records over last capture interval..8939 

Avg records per hour................ 172994 

Avg volume space used per minute....180 KB/min 

Avg volume space used per hour...... 10808 KB/hr 

Last capture interval............... 00:03:06 

Begin-end of last capture interval..17:50:09 - 17:53:15 

Next schedule capture time.......... 17:55:09 

Last manual capture time.......... 97/01/01 15:46:22 
---ERROR CONDITIONS---— REQUEST PEND 


Explanation: 
The operation was successful. It was completed on field processor 0 
(FPO) at 17:53:15. 


Note: Because the scheduler on each node performs this audit every 
ten minutes, the last capture interval will never exceed ten minutes. 
When issuing this command, be aware of the next scheduled capture 
time so that the command will not cause the next capture interval to 
be too short. The longer the capture interval, the more realistic the 
averages. If the next schedule capture time is approaching, it is 
better to allow the scheduler to perform the audit. Then use the “info 
<appl> rec” command to view the results. 


User action: 
None 


occ VOL DKOOFTF1 Completed on FPO. 


Vt 


SZ (M) FR% A% U% P% R3% N% STATE ER FILES 


600 92 1 3 4 0 0 OK 0 3 


Explanation: 

The operation was successful and the volume is OK for recording. 
The results of the audit are displayed identically to the “INFO 
<appl> VOL” response. 


User action: 
None 
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AUDIT (continued) 
AUDIT OCC ALL Completed on FPO. 
- Counts from 95/02/12 20:04:13 - 
-—--VOLUME ERR--- ---FILE ERR--- 
SPACE 
V# FR% AS U% P% R% N% STATE SP AC FL IO FS CR OP WR CL RN DL 
0 65 31215 0 5 OK oO 0 O O0 0 Q GO 0 O 0 0 
1 36 0 46 10 8 IN ERROR O0 2 1 0 0 1 0 0 0 0 0 
V# LAST ERROR DETECTED: 
1 Device unavailable 
OPERATION: ACCESS 
Explanation: 


The operation was successful and the VOLUME ERR and FILE 
ERR counts were last reset at the time indicated. The error 
descriptions are listed for each volume that is INERROR along with 
the operation that caused the error. 


User action: 


None 
AUDIT OCC SPACE Completed on FPO. 
InSv P space recovered during audit........ 37 MB 3% 
POOL Volume chosen for next file .......... 0 MB 
SPACE Total. Spa@e@ie we asss saaneessa diedie Sosa we ree oS 1234 MB 
Free SPCC. be seed 6 Ghee bedd Sob Soe ee eee 486 MB 39% 
Active space........ (A £2168) secre siecccs eee 56 MB 5% 
Unprocessed space...(U files)......... 306 MB 25% 
Processed space..... (P Files] acca evsisi a 3 ois 298 MB 24% 
Removed space....... (R £11ES8) wie cwe es 0 MB 0% 
Non-usable space... (Non-DRM).......... 89 MB 71% 
Available recording space. (free + P). 784 MB 64% 
Explanation: 


The response indicates that the operation was successful and displays 
the results. The “P space recovered” is the amount of new free space 
made available due to the processed (P) file deletion that occurs 
during the space audit. 


User action: 
None 


Digita 
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AUDIT (end) 


Execution of the AUDIT <appl> ALL/VOL/FDIR commands may 
impact the recording/transfer throughput on the target node 
for the duration of the audit. These commands (ALL in 
particular) are CPU intensive. 


Explanation: 
See response. 


User action: 
None 


Error messages 
See “Responses” section. 


Related commands 
The following commands are found in the DRM directory: 


e COPY 

e DAT 

e DEMOUNT 
e INFO 

e MONITOR 
e MOUNT 

e QUIT 

e RENAME 
e RESET 

e ROTATE 

e TCOPY 

e VIEW 
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Purpose 
The Copy (COPY) command copies Device Independent Recording Package 
(DIRP) files that are located on the computing module (CM) or the Ethernet 
Input/Output Controller (EIOC) to the Distributed Recording Manager 
(DRM) system. 


Note: The DIRP file that resides on CM or EIOC is copied to the file 
processor (FP). The file is added to the the DRM file directory. The DIRP 
file continues on CM or EIOC disks. 


Restrictions 
Limitations associated with COPY include: 
e Only DIRP files can be copied and added to the DRM file directory. 
e Complete filenames must be cited in the command line. 


e Only closed DIRP files can be copied and added to the DRM file 
directory. 


Note: Active (A) files may not be copied/added to DRM. Only closed 
and processed (P), closed and removed (R), or closed and unprocessed 
(U) files may be added. 


e FP must have enough space the copy the DIRP file. 


e DIRP file being transferred by AUTOXFER (AFT) cannot be moved to 
DRM. 


e Only one DRM copy can be executed at any given time. 


Access 

>DRM 
Syntax 

>COPY vol_nm file_nm from_nd to_nd [filestate nochange] 
Parameters 


Command parameters are described in Table 1-75. 
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COPY (continued) 


Table 1-75 
COPY parameter descriptions 
Parameter Values Description 
vol_nm 1 to 17 Specifies the DIRP volume where the file to be 
alphanumeric copied is located. 
characters 
file_nm 1 to 8 Specifies the complete DIRP filename located in 
alphanumeric table DIRPHOLD. 
characters 
from_nd Valid values include: Specifies the CM or EIOC node where the DIRP 
file to be copied is located. 
CM—computing 
module 
ElOC—Ethernet 
Input/Output 
Controller 
to-nd string Specifies the DRM application where the copied 
file is added. 
Note: The DRM filename is obtained from the 
timestamp in the DIRP filename. The DRM file 
is placed in the DRM file directory under the 
specified application. 
filestate Valid values include: Specifies the state of the file copied to DRM. 
(optional 
parameter) Note: The file state cannot be changed to ”active” 
(A) while copying to DRM. 
U File status is “closed and unprocessed”. 
P File status is “closed and processed”. 
R File status is “closed and removed”. 
nochange nochange Specifies that the DIRP file on the CM/EIOC is to be 
(optional left in the same file state as existed before the copy 
parameter) process began. 


Note: This is the default parameter when nothing is 
entered into “filestate”. 


—end— 
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COPY (continued) 


Example command 


Responses 


>copy c00000cc u9111071240ama cm occ p 


Note: In the command example the following values are used to copy DIRP 
files from the CM to the FP: 

e cQ000—DRIP volume name 

e u91110—DIRP filename 

e cm—node from which the file is copied 

e occ—name of application where file is added 


e p—tfile status is “closed and processed” 


The following are possible responses to the COPY command: 


Copied to DRM file: 
PN91111071240000CC 
Copying record number: 100 
Copying record number: 200 


-DRM COPY DONE 
OPERATION SUCCESSFUL 


Explanation: 

The file is added to the DRM file directory under the OCC 
application. The state of the DRIP file will change to “P”. The 
new file name is PN911110712400000CC. 
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COPY (continued) 


User action: 
None 


Buffer not available 
OPERATION FAILED 


(or) 


Resources not available - TRY LATER 
OPERATION FAILED 


Explanation: 
The buffers/resources necessary to execute the COPY command are 
not available. The COPY command is terminated. 


User action: 
None 


Note: This response is a warning that the CM/EIOC is experiencing 
problems allocating resources (buffers, etc.) needed to execute the 
COPY command. 


Command blocked by another DRM COPY command - TRY LATER 
OPERATION FAILED 


Explanation: 
The COPY command was issued while the DRM COPY software 
was already processing a previously issued COPY command. 


User action: 
Wait until the current COPY command is executed. COPY can be 
re-issued after the current command has finished its execution. 
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COPY (continued) 


Copied to DRM file: 
PN91111071220000CC 
Copying record number: 100 
Copying record number: 200 


DRM 


COPY DONE 


OPERATION SUCCESSFUL 


Explanation: 

The system successfully processed the command. A message 
“copying record number: XX” is displayed after copying every 100th 
record. 


User action: 
None 


DIRP file locked by AUTOXFER - TRY LATER 
OPERATION FAILED 


Explanation: 
The DIRP file that was requested to be copied to DRM is currently 
being transferred or processed by AFT. 


User action: 

Enter a different file name that is not currently being transferred or 
processed. Browse through table DIRPHOLD and obtain a different 
file name to copy. 


DIRP FILE NOT FOUND 
OPERATION FAILED 


(or) 


DIRP file info not found 
OPERATION FAILED 


Explanation: 
The system cannot find the specified DIRP filename on the 
CM/EIOC volume. 


User action: 
Obtain the correct filename from table DIRPHOLD located on the 
CM or on the EIOC. 
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DIRP file not in TABLE DIRPHOLD 
OPERATION FAILED 


Explanation: 
The DIRP file that was requested to be copied to DRM is not present 
in table DIRPHOLD. 


User action: 

Enter a file name that is present/datafilled in table DIRPHOLD. 
Browse through table DIRPHOLD and obtain a different file name to 
copy. 


DRM APPL name NOT VALID 
OPERATION FAILED 


Explanation: 
User attempted to copy a DIRP file to a DRM file that belongs to an 
application unknown to the system. 


User action: 

The DRM application mentioned in the command line is not 
registered with DRM. The info command in the 
“MAPCI;MTC;APPL;OAMAP;DRM” level of the MAP displays all 
the applications registered with DRM. 


DRM file deleted 
OPERATION FAILED 


Explanation: 
The COPY command failed. 


User action: 
Look at the error condition that terminated the DRM COPY 
command. 


Error reading DIRP file 
OPERATION FAILED 


Explanation: 
The COPY command failed due to a system error. 


297-2621-819 Standard 14.01 April 2002 


Commands 1-323 


DRM commands 
COPY (continued) 


User action: 
None 


Note: This response indicates that the file system is experiencing 
difficulties, or the file is inaccessible due to invalid device status or 
due to a restart on the node (CM or EIOC). 


Error while writing to DRM file 
OPERATION FAILED 


(or) 


Error while writing and closing DRM file 
OPERATION FAILED 


OP 


Explanation: 
The COPY command failed due to a file system error. 


User action: 
None 


Note: This response indicates that the file system is experiencing 
difficulties. It could also indicate that the file is inaccessible due to 
invalid device status or due to a restart on the node (CM or FP). The 
file system error message is displayed for diagnostics purposes to 
help correct the problem. 


Error writing to buffer 
ERATION FAILED 


Explanation: 
An error condition has occurred on the EIOC while writing to the 
buffer to be sent to the CM. The COPY command is terminated. 


User action: 
None 


Note: This response is warning that the EIOC is experiencing 
difficulties while writing to the buffers to be sent to the CM. 


Invalid buffer sequence 
OPERATION FAILED 
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Explanation: 
An error condition has occurred due to out of sequence arrival of the 
buffers from the EIOC. The COPY command is terminated. 


User action: 
None 


Note: This response warns that the buffers are arriving out of 
sequence from the EIOC. 


Invalid DIRP file hold state 
OPERATION FAILED 


Explanation: 
The file “hold” state of the DIRP file that was requested to be copied 
to the DRM is invalid. 


User action: 
Enter a file name with a valid “hold” state. Browse through table 
DIRPHOLD and obtain a different file name to copy. 


Invalid DIRP filename 
OPERATION FAILED 


Explanation: 
The user issued the COPY command with an invalid DIRP volume 
name (i.e., invalid “from_vol” parameter). 


User action: 
Re-issue the COPY command with the correct DIRP volume name. 


Invalid optional parameter 
OPERATION FAILED 


Explanation: 
The user issued the COPY command with an invalid optional 
parameter. 


User action: 
Re-issue the COPY command with the correct optional parameter. 
The valid optional parameter is “nochange”; the default is “change”. 


Necessary package for copying EIOC files not present 
OPERATION FAILED 
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Explanation: 
The COPY command terminated because the necessary software 
package for copying EIOC files to DRM is not present on the switch. 


User action: 
Obtain the necessary software package to copy the DIRP file on the 
EIOC to the DRM. 


Necessary package for DRM COPY not present 
OPERATION FAILED 


Explanation: 
The COPY command terminated because the necessary software 
package for COPY command is not present on the switch. 


User action: 
Obtain the necessary software package to copy the DIRP file to the 
DRM. 


No response from EIOC 
OPERATION FAILED 


Explanation: 
An error condition has occurred on the EIOC, and there is no 
response from EIOC. The COPY command is terminated. 


User action: 
None 


Note: This response is a warning that a communication problem 
exists between the CM and the EIOC, either due to instable EIOC 
link or due to a restart on the EIOC. 
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Non-Active volumes not large enough or unavailable 
OPERATION FAILED 


Explanation: 

The user attempted to copy a DIRP file to a DRM file, and the 
volumes allocated to the DRM application do not have enough space 
to copy the DIRP file. 


User action: 

Increase the recording space for that application to copy the DIRP 
file. The recording space can be increased by mounting the volume 
against the application or by reducing the “retention period” for the 
application in table DRMAPPL. 


Source device must be a disk device 


OP 


ERATION FAILED 


Explanation: 
The device on which the DIRP file exists must be a disk device. The 
COPY command is terminated. 


User action: 
Obtain the DIRP file that resides on the disk devices. 


Unable to close DIRP file 
OPERATION FAILED 


Explanation: 
The COPY command failed due to a system error. 


User action: 
None 


Note: This response indicates that the file system is experiencing 
difficulties, or the file is inaccessible due to an invalid device status 
or due to a restart on the node (CM or EIOC). 


Unable to close DRM file 


OP 


ERATION FAILED 
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Explanation: 
The COPY command failed due to a FTFS file system error. 


User action: 
None 


Note: This response indicates that the file system is experiencing 
difficulties. It could also indicated that the file is inaccessible due to 
an invalid device status or due to a restart on the node (CM or 
EIOC). 


Unable to create DRM file 


OP 


ERATION FAILED 


Explanation: 
The COPY command failed due to an FTFS file system error. 


User action: 
None 


Note: This response indicates that the file system is experiencing 
difficulties. 


Unable to delete DRM file 


OP 


ERATION FAILED 


Explanation: 
The COPY command failed due to an FTFS file system error. 


User action: 
None 


Note: This response indicates that the file system is experiencing 
difficulties. It also could indicate that the file is inaccessible due to 
an invalid device status or due to a restart on the node (CM or FP). 


Unable to open DRM file 
OPERATION FAILED 
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Explanation: 
The COPY command failed due to an FTFS file system error. 


User action: 
None 


Note: This response indicates that the file system is experiencing 
difficulties. It also could indicate that the file is inaccessible due to 
an invalid device status or due to a restart on the node (CM or FP). 


Unable to send buffer to CM 


OP 
(o 


ERATION FAILED 
r) 


Unable to send message to CM 


OP 


ERATION FAILED 


Explanation: 

An error condition has occurred on the EIOC and the EIOC is unable 
to send the buffer/message across to the CM. The COPY command is 
terminated. 


User action: 
None 


Note: This response is a warning that a communications problem 
exists between the CM and the EIOC, either due to an instable EIOC 
link or due to a restart on the EIOC. 


Unable to send message to EIOC 
OPERATION FAILED 


Explanation: 

An error condition has occurred on the CM and the CM is unable to 
send the message across to the EIOC. The COPY command is 
terminated. 


User action: 
None 


Note: This response is a warning that a communications problem 
exists between the CM and the EIOC, either due to an instable EIOC 
link or due to a restart on the EIOC. 


Volume not found 
OPERATION FAILED 
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Explanation: 
The user attempted to copy a DIRP file from the DIRP volume that 
does not exist 


User action: 

Enter a different volume name that has been mounted against the 
subsystem. Browse the tuple in table DIRPPOOL and obtain the 
volume name that can be used to copy the DIRP file to a DRM file or 
list all volumes that exist on CM/EIOS by typing “print rootdir” from 
the CI prompt. 


Error messages 
See “Responses” section. 


Related commands 
The following are found in the DRM directory: 


e AUDIT 

e DAT 

e DEMOUNT 
e INFO 

e MONITOR 
e MOUNT 

e QUIT 

e RENAME 
e RESET 

e ROTATE 

e TCOPY 

e VIEW 
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Purpose 
The Digital Audio Tape (DAT) command copies DRM files to and from a 
digital audio tape (DAT). The command is also used to query information 
about files on a DAT tape. 

Access 
>DRM 

Syntax 
>DAT subcommand options 

Parameters 
Command parameters are described in Table 1-76. 

Table 1-76 


DAT parameter descriptions 


Parameter Values 


Description 


subcommand Valid values include: 
(E)JECT 


QUERY 


M(OUNT) 


R(ESTORE) 


V(ERIFY) 


Demounts the currently mounted DAT tape and 
ejects the tape from the drive. 


Note: Another tape must be mounted before issuing 
any other DAT commands. 


Displays information on the currently mounted DAT 
device. 


Mounts the currently inserted tape into the drive. 


Note: |ssue this command first. Use other 
subcommands (W, V, R, and E) to reference the 
currently mounted tape. This subcommand accepts 
the following optional parameters: “dat_drive”, 
“nodename’”, “tapeform”, and “init”. 


Copies a DRM file from tape back to disk. This 
subcommand accepts the following optional 
parameter: “filetmpl”. 


Scans the contents of the mounted tape and displays 
information about the files found on the tape. 


—continued— 
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Table 1-76 
DAT parameter descriptions (continued) 
Parameter Values Description 
W(RITE) Writes a file to the mounted DAT tape, placing it after 
the last file on the tape. If “init” was used in the 
mount process, the file writes at the beginning of the 
tape. This subcommand accepts the following 
parameters: “applid” and “filetmpl”. 
options Valid values include: 
(optional 
parameters) 


stream 
(applid) 


dat_drive 


filetmpl 


init 


Specifies the ID (key) of an application in table 
DRMAPPL. If not supplied, the system displays all 
keys from table DRMAPPL. 


Note: OCC is the pre-defined call data stream name 
for a UCS DMS-250 switch. 


Specifies the name of the DAT tape drive to be 
mounted. The drive name format is “CTyy”, where 
“yy” is the DAT drive number. 


Specifies the file name template. It is made up of the 
first character of a file name followed by any number 
of characters that sufficiently identify one or more 
files. It must begin with “U”, “P”, “R”, or “$”. $ may be 
a wild card for any number of characters in the 
template. If the template is not a complete file name, 
a list of matched names displays. 


Note: This parameter is required if a stream name 
(“applid”) is supplied. 


Specifies an initial DAT tape mounting or indicates 
overwriting the existing data. 


Note: This command must be used when mounting 
a DAT tape for the first time; otherwise, the mount 
fails. When using an existing tape, the system writes 
a new “volid” on the tape and overwrites the previous 
content. 


—continued— 
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Table 1-76 
DAT parameter descriptions (continued) 
Parameter Values Description 
nodename Specifies the node where the DAT drive resides 
(FPO, FP1). 
tapeform Specifies the values that can be selected for the tape 


format. Currently, NT and ANSI9 are accepted. 


—end— 


Example command 
>DAT query 


Responses 
The following are possible responses to the DAT command: 


Device name: Node: Last mounted by CI: Status: 

CTO02 FFO MAP 32 In Use 

CTO2 FFL MAP30 In Use 

CTO03 FFO MAP 41 Free 
Explanation: 


The name of the node where each mounted DAT device resides is 
displayed. This is the node name specified in the mount parameter. 
The “Status” field indicates whether the mounted device is being 
used by the “Last mounted CI” MAP terminal. “In Use” means that 
the device is being used and cannot be remounted by another CI. 
“Free” means that another CI terminal can remount the device. 


User action: 
None 


DAT Tape is not a DRM tape. 


Explanation: 
An attempt was made to MOUNT a tape without an “init” request. 
The tape has not previously been initialized for use by the DRM. 


User action: 
Remount the tape with the “init” option or use a different tape. 
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Ejecting tape ... Tape ejected. 
Explanation: 
An EJECT was issued. 


User action: 
None 


File UN9205090109000CC already exists in the DRM directory. 
Do you wish to overwrite it (Y or N)? 


Explanation: 
A RESTORE was issued, but the file to be restored from tape already 
exists in the DRM directory. 


User action: 

To proceed with the restoration, enter “Y”. The version of the file on 
disk is deleted and replaced with the version on tape. To stop the 
procedure enter “N”. 


File UN9205090109000CC cannot be restored to disk. There is 
insufficient disk space. 


Explanation: 
A RESTORE was issued, but there is insufficient disk space to 
restore the indicated file. 


User action: 

There are two things that may be done to increase the amount of 
available space. First, mount another volume for the given 
application, increasing the amount of available space. Second, back 
up other files to tape and ensure that they have been processed (in the 
“P” state) so that they are eligible for deletion. 


File UN9205090109000CC is being restored to the DRM disk .. 
Restoration complete. 


Explanation: 
A RESTORE was issued. 


User action: 
None 
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Mounting tape CTO5 ... 
Tape CTO5 is mounted. 


OP 


Explanation: 
The system successfully mounted the tape. 


User action: 
None 


ERATION FAILED. Copy of active file is not permitted 


Explanation: 
A WRITE was issued attempting to backup the active file. 


User action: 
Wait until the next ROTATE (this may be forced manually), and then 
copy the file to tape. 


OPERATION FAILED. CTO5 in use by another CI. 


Explanation: 
An attempt was made to MOUNT a tape, and the tape drive is 
already in use by some other CI process. 


Note: Only one process at a time can own the tape drive. When 
attempting to mount the tape, but another process already has a tape 
mounted in ths drive, the operation cannot proceed. 


User action: 
Wait until the tape drive is free, or EJECT the tape from the CI to 
which it is mounted. 


OPERATION FAILED. DAT1 is not a valid device name. 


Explanation: 
An attempt was made to MOUNT a tape, and the tape drive is not a 
valid DAT drive name. 


User action: 

Check the Device Inventory table (FPDEVINV) for the information 
needed to create DAT drive names in the format “xxyy” where xx is 
the FP number, and yy is the device number. 
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OPERATION FAILED DUE TO UNEXPECTED DAT TAPE ERROR. 


OP 


OP 


Explanation: 
An unrecoverable error occurred with the DAT tape or DAT tape 
drive. An alert is generated to record the error condition. 


User action: 
Check the system log to discover the nature of the problem. 


ERATION FAILED. File belongs to unregistered application. 


Explanation: 
A RESTORE was issued attempting to restore a file that belongs to 
an application unknown to the system. 


User action: 
Wait for the application to initialize, then re-enter the RESTORE 
request. 


ERATION FAILED. Invalid application ID is specified. 


Explanation: 
A WRITE was issued specifying an invalid application ID. 


User action: 

re-enter the WRITE specifying a different application ID. If 
necessary, issue a WRITE with no other parameters to see a list of 
valid application IDs. 


ERATION FAILED. It is necessary to MOUNT a tape before 


preforming this operation. 


Explanation: 
A WRITE, VERIFY, RESTORE, or EJECT was issued without 
having a tape currently mounted. 


User action: 
MOUNT a tape and repeat the request. 
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OPERATION FAILED. Maximum devices mounted. 


OP 


Explanation: 
An attempt was made to MOUNT a DAT, but the maximum number 
is already mounted. 


User action: 
A DAT must be EJECTed by one of the other CI processes. 


ERATION FAILED. No files match the specified template. 


Explanation: 
A WRITE or RESTORE was issued specifying a filename template, 
but the system can find no files matching the template. 


User action: 

Re-enter the WRITE or RESTORE specifying a different filename 
template. If necessary QUERY the DRM filelist or VERIFY the tape 
to see what files are present. 


OPERATION FAILED. Please make sure that a tape is in the DAT 
tape drive. 


Explanation: 
A MOUNT or RESTORE was attempted without a tape physically 
present in the tape drive. 


User action: 
Install a DAT in the drive and re-issue the MOUNT. 


OPERATION FAILED. Tape is WRITE PROTECTED. 


Explanation: 
A MOUNT CTyy INIT or WRITE on a tape that has write protection 
enabled is attempted. 


User action: 
EJECT the tape. Remove the write protection. Remount the tape and 
proceed. 
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OPERATION FAILED. While attempting to access file 
UN920509010900CC the following file system error occurred: 
Input/Output error. 


Explanation: 
The DAT operation failed due to a file system error. 


User action: 

This response is a warning that the file system is experiencing 
serious difficulties. The file system error message is displayed for 
diagnostics purposes to help correct the problem. 


OPERATION SUCCESSFUL: The device was already mounted. 


Explanation: 
A DAT type was remounted that was already mounted in DRM but 
not owned by a CI process. 


User action: 
None 


OPERATION SUCCESSFUL: 
The device was already mounted. INIT option ignored until DAT 
is EJECTed. 


Explanation: 

A DAT type was remounted that was already mounted in DRM but 
not owned by a CI process, and the “init” was specified. For 
example. DAT MOUNT FPOOCT04 INIT. 


User action: 
If the DAT is to be initialized, then it must be EJECTed and 
reMOUNTed with the “init”. 


Tape contains: 


UN920509109000CC 92/06/26 8 


Explanation: 
A VERIFY was issued. For each file on the tape, the filename, 
creation date, and size in blocks is shown. 


User action: 
None 
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These files match the supplied filename template: 
1. UN9205062028000CC 

2. UN9205062055000CC 

3. UN9205080300000CC 

4. UN9205080444000CC 

5. UN9205080453000CC 

1. UN9205080833000CC 6 


Select a file number or enter QUIT: 


Explanation: 
A WRITE was issued specifying a filename template matching more 
than one filename. 


User action: 
Enter either the number of the filename to be written to tape or QUIT 
to abort the operation. 


WRITING FILE UN9205090209000CC ,,, 
OPERATION SUCCESSFUL 


FILE UN9205090209000CC is written. 


Explanation: 
A WRITE was issued. 


User action: 
None 


WRITING FILE UN9205090109000CC ,,, 
Writing failed. There is not enough room on the tape to 
complete the file copy. 


Explanation: 
A WRITE was issued, but the tape does not have enough room to 
accommodate the file being written. 


User action: 
Copy the file again onto a fresh tape. 


Error messages 
See the “Responses” section. 


297-2621-819 Standard 14.01 April 2002 


Commands 1-339 


DRM commands 
DAT (end) 


Related commands 
The following are found in the DRM directory: 


e AUDIT 

e COPY 

e DEMOUNT 
e INFO 

e MONITOR 
e MOUNT 

e QUIT 

e RENAME 
e RESET 

e ROTATE 

e TCOPY 

e VIEW 
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Purpose 
The Demount (DEMOUNT) command removes a volume from a recording 
application’s pool. This action makes the volume and its contents 
inaccessible to the recording application/system. 

Access 
>DRM 

Syntax 
>DEMOUNT stream name volname | volnum 

Parameters 
Command parameters are described in Table 1-77. 

Table 1-77 


DEMOUNT parameter descriptions 


Parameter Values Description 
stream OCC Specifies the pre-defined call data stream name for 
(applid) the UCS DMS-250 switch. 


Note: OCC designates a UCS DMS-250 switch. 


volname 20 alphanumeric Specifies the name of volume being demounted. 
characters 
Note: The name must match one of the volumes 
assigned to the data stream in table DRMPOOL. If 
“volnum” is defined, this parameter is not needed. 


volnum string Specifies the number of the volume in the 
application’s pool in table DRMPOOL. The first 
position is 0. 


—end— 


Example command 
>DEMOUNT occ dk00occ1 
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Responses 


The following are possible responses to the DEMOUNT command: 


OPERATION SUCCESSFUL: 
Volume DKOOOCC1 has been 
removed from OCCPOOL 


Explanation: 
DEMOUNT was successful. 


User action: 
None 


OPERATION SUCCESSFUL: Volume DKOOOCC has been removed from 
OCCPOOL. 


OP 


Explanation: 
DEMOUNT failed because the specified volume does not exist in 
the application’s pool in table DRMPOOL. 


User action: 

A list of the mounted or allocated volumes may be obtained by 
listing the application’s tuple in table DRMPOOL or by using the 
“info <applid> vol” command. 


ERATION FAILED: Volume DKOOOCC1 cannot be demounted. 


Reason: Volume contains ACTIVE file. 


Explanation: 

DEMOUNT failed because the specified volume contains the 
application’s ACTIVE file. All files on a volume must be either “U” 
(unprocessed), “P” (processed), or “R” (removed) before the volume 
can be removed from the application’s pool. 


User action: 

Use ROTATE to close the current ACTIVE file on the volume, and 
open a new ACTIVE file on an alternate volume. If there are no 
alternate volumes available for the ACTIVE file, then the volume 
may not be demounted. An application must always have at least one 
volume available for the ACTIVE file. 
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OPERATION SUCCESSFUL: Volume DKOOOCC1 has been removed from 
OCCPOOL. 


Explanation: 
The system was able to deallocate the volume for OCC’s pool in 
table DRMPOOL. 


User action: 
None 


Volume DKOOVOL1: Does not contain an ACTIVE file, but it is 
the only volume allocated to OCC. Demounting this volume will 
disallow further recording by OCC until additional volume 
space is made available. 


Perform Demount operation? (YES/NO, or QUIT): 


Explanation: 
The DEMOUNT command requires a confirmation from the user 
because the specified volume is the only one available for recording. 


User action: 
Enter either YES or NO. “Yes” tells the system to proceed with the 
demount procedure. “No” aborts the demount procedure. 


Be aware than entering YES disallows recording of the application’s 
data until more volume space is made available in one of the 
following ways: 


— U (unprocessed) or R (removed) files are renamed to P 
(processed), or a file is deleted on a volume in FULLU state, and 
then an AUDIT or RESETVOL is done to change its state to OK. 


— volumes in ERROR state are repaired and then returned to 
service using the RESETVOL command. 


— volumes are added to the application’s pool in DRMPOOL by 
way of the MOUNT command. 


Note: If the specified volume contains the ACTIVE file, and no 
volumes are available for recording (ROTATE), then the volume may 
not be demounted. 
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When a volume is demounted, or removed using this command, 
its contents are no longer accessible and protected by the 
recording system. The files on demounted volumes are 
vulnerable to deletion by the system and craftpersons. The 
user should ensure that the files are no longer needed, this 
is, all files are “processed” before demounting the volume. 


Explanation: 
None 


User action: 
None 


Related commands 
The following are related DRM commands: 


e AUDIT 

e COPY 

e DAT 

e INFO 

e MONITOR 
e MOUNT 
e QUIT 

e RENAME 
e RESET 

e ROTATE 
e TCOPY 

e VIEW 
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Purpose 
The Information (INFO) command displays valid stream names and current 
stream information. This includes registration, status, volume, file, audit, 
and rotation information. This command also lists the applications known to 
the Distributed Recording Manager (DRM). 
Access 
>DRM 
Syntax 
>INFO stream info_type options 
Parameters 
Command parameters are described in Tables 1-78. 
Table 1-78 
INFO parameter descriptions 
Parameter Values Description 
stream OCC Specifies the pre-defined call data stream name for 
(applid) the UCS DMS-250 switch. 


Note: OCC designates a UCS DMS-250 switch. 


info_type Valid values include: 

FIL Requests information on files matching the supplied 
“filetmpl’, “fstates”, or “all” files. 

NODES Lists all DRM nodes used by the specified stream. 

REG Lists registration information for each DRM. 

SCHED Displays audit schedules. 

ROT Displays rotation schedule and prioritized rotate 
volume list. 

VOL Displays volume information. 

VOLDIAG Displays trouble diagnostics information on all 
mounted volumes. 

VOLLERR Displays last error detected on each mounted 
volume. 

—continued— 
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Table 1-78 
INFO parameter descriptions (continued) 
Parameter Values Description 
VOLFIL Displays mounted volumes and their files. 
options Valid values include: 
ALL Displays information on all volumes or files. 
actv Displays “active” volume. 
destnode Specifies destination node name. 
filetempl Displays first character of a file name followed by any 
number of characters that sufficiently identifies one 
or more file. A “$” may be used to wildcard any 
number of characters on the template. 
volume Specifies the volume name or reference number from 
DRMPOOL. 
volnode Specifies the name of the node where volumes 


reside. 


—end— 


Example command 
>INFO occ all 


Digital Switching Systems UCS DMS-250 Commands Reference Manual UCS17 


1-346 Commands 


DRM commands 
INFO (continued) 


Responses 
The following are possible responses to the INFO command: 


Registration Information: 

Application ID OCC 

Application status: Active 

Node FPO 

Date and time of last registration 
97/01/17 09:32 

Number of registrations 
1 


Requested fixed or variable 
blocks Fixed 
Requested block size .2048 B 
Requested to allow 
CLOSTATE = PNO 
SPACE Records written last audit interval 23168 
AUDIT Avg records per hour 


139008 
Avg volume space used per minute 290 KB/min 
AVG volume space used per hour 17400 KB/min 
Last audit interval 00:10:00 
Begin of interval 14:10:00 
End of interval 14:20:00 
Next scheduled audit time 14:30:00 
Last manual audit 97/01/17 10:38:00 
VOLUME Number of volumes allocated9 
TROUBLE INERROR: 2 6 
FULLU: 3 4 8 
InSV Total space 1200 MB 
POOL Free space 1120 MB; 93% 
SPACE Active space (A files) 5 MB; 1% 
Unprocessed space (U files) 52 MB; 4S 
Processed space (P files) 2 MB; 2% 
Removed space (R files) 0 MB; 0% 
Non-usable space (Non-DRM) 0 MB; 0% 


Available recording space (free + P) 1142 


Z 
W 
Ne} 
ol 
ale 


(continued) 
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(continued from previous page) 


FILES Number of files 74 
Active files 1 
Unprocessed files 25 
Processed files 48 
Removed files 0 
ROTATE Next scheduled ROTATE (date and time) ... 97/10/17 
15:00:00 
Volume chosen for next file 1 
Volumes available (OK): 0 5 7 
Last ROTATE occurred (date and time) ... 97/01/17 14:00:00 


Cause of last ROTATE Schedule 
State assigned to files when closed U 


Explanation: 
The application’s pertinent registration information, and summary 


information for the various types of available queries (for example, 
audit, volume, file, rotate) are displayed. 


User action: 
None 


OPERATION FAILED. inter-node connection is down. 


Explanation: 


The command could not be sent to the file processor (FP) because 
the inter-node connection was down. 


User action: 

Return the FP to service (RTS) . The FP must be stable before the 
inter-node connections can be re-established. The DRM 
automatically re-establishes the connection. 
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OPERATION FAILED. OCC has no files of the requested type. 


Explanation: 
One of the following was entered: 


info occ filetmpl all 
info occ fstate all 


and no files exist to satisfy the request. If at least one file in one of 
the requested file states or template exists, that file’s information in 
displayed, and this response does not appear. 


User action: 
None 


OPERATION FAILED. Software error occurred while sending 
message. A software error log has been generated. 


Explanation: 
The command could not be sent to the file processor (FP) because 
the DRM system found a software error. 


User action: 

Retain the software error log for reference when consulting the DRM 
software maintenance personnel. A warm restart may be required to 
clear up the problem if it persists. 


OPERATION FAILED. The requested volume is not allocated. 


Explanation: 
The DRMPOOL tuple for OCC does not have the volumes requested. 


User action: 
Volumes may be allocated for the application by way of the MOUNT 
command. 


OPERATION FAILED. There are no volumes allocated to this 
stream. 


Explanation: 
The DRMPOOL tuple for OCC is empty. 


User action: 
Volumes may be allocated for the application by way of the MOUNT 
command. 
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Press <CR> to continue, or enter QUIT: 


Explanation: 
More responses are expected from the FP. For example: 


— The DRM system on the FP is not finished responding to the 
command. 
— The DRM Cl is waiting for additional responses from the FP. 


User action: 
None 


Request aborted! 


Explanation: 
The command was aborted and was never sent to the file processor 
(FP). This occurs only when the following prompt appears before the 
command is sent to the FP, and QUIT is entered. 

“Press <CR> to continue, or enter QUIT:” 


>== Request sent ==> 


Explanation: 
The command was successfully sent to the file processor (FP) for 
processing. 


User action: 
None 


Response preempted! 


Explanation: 

The response was preempted, and no more responses will be 
displayed for the entered command. The response is preempted in 
one of two ways: 

— No response was received. 

— QUIT was entered at the following prompt: 


Press <CR> to continue or enter QUIT: 


User action: 
None 
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RESPONSE READY. 


Explanation: 
A response from the FP is ready to be displayed. 


User action: 
Press <CR> to display the response, or enter QUIT to abort the 
response. 


Sending request... 


Explanation: 
A command was successfully entered. 


User action: 
None 


System was busy. Try again. 


Valid 


OCC 
OM 
JF 
OCC 


Explanation: 
The command could not be sent to the FP because the DRM system 
did not have enough resources available to process the request. 


User action: 
The command may be repeated until the DRM system no longer 
rejects it. 


DRM stream names: 


Explanation: 

The stream name (“applid’’) is not supplied or is not valid. The 
response presents a list of all valid application IDs located in table 
DRMAPPL that may be used as the stream name. 


User action: 
None 


Error messages 
See “Responses” section. 
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INFO (end) 


Related commands 
The following are related DRM commands: 


e AUDIT 

e COPY 

e DAT 

e DEMOUNT 
e MONITOR 
e MOUNT 

e QUIT 

e RENAME 
e RESET 

e ROTATE 

e TCOPY 

e VIEW 
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MONITOR 
Purpose 
The Monitor (MONITOR) command displays information about an 
application’s current active file in real time. 
Access 
>DRM 
Syntax 
>MONITOR stream 
Parameters 
Command parameters are described in Table 1-79. 
Table 1-79 


MONITOR parameter description 


Parameter Values Description 
stream OCC Specifies the pre-defined call data stream name for 
(applid) the UCS DMS-250 switch. 


Note: OCC designates a UCS DMS-250 switch. 


—end— 


Example command 
>MONITOR occ 
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MONITOR (continued) 


Responses 


The following are possible responses to the MONITOR command: 


Monitoring OCC ACTN FPO VOL :FPO/DKOOFTFS1 


FILE NAME BLOCKS BLKSZ T RECORDS FLSZ-KB ER V# 
AN9202021955000CC 2509 2048 F 40144 5018 0 0 
Explanation: 


The response is a real-time display of OCC’s active file information, 
updated once a second. Information contained in the response 
includes: 


— ACTN is the stream’s “Active” (A) node from which the stream 
data is written to the file. “None” indicates that an old active file 
has been recovered but there is not active node because the 
stream has not yet registered on any DRM node and the file is not 
open. 


— VOL is the global path of the volume containing the file. 
— BLOCKS is the number of blocks of records written to the file. 
— Tis the block type, that may be “F” (fixed) or “V” (variable). 


— RECORDS is the number of records written to the file. If a “?” is 
displayed, then it is an old active file that has been recovered 
from disk and the number of stream records in the file cannot be 
determined. 


— FLSZ-KB is the actual size of the file in Kbytes. 


— ER is the number of errors that have occurred while attempting to 
perform some operation on the file. 


— V#is the volume reference number in the stream’s volume pool 
(DRMPOOL tuple). 


User action: 
None 
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MONITOR (end) 


Monitoring OCC 
FILE NAME 


(no active file) 


Explanation: 


ACTIN FPO 
BLOCKS BLKSZ T RECORDS FLSZ-KB ER V# 


VOL 


OCC does not have an active file. The response is a real-time display 
of the OCC’s active file information that is updated every three 


seconds. 


User action: 
None 


Error messages 


See “Responses” section. 


Related commands 
The following are related DRM commands: 


AUDIT 
COPY 
DAT 
DEMOUNT 
INFO 
MOUNT 
QUIT 
RENAME 
RESET 
ROTATE 
TCOPY 
VIEW 
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MOUNT 


Purpose 
The Mount (MOUNT) assigns a recording volume to an application. 
Access 
>DRM 
Syntax 
>MOUNT stream volname nodename priority 
Parameters 
Command parameters are described in Table 1-80. 
Table 1-80 
MOUNT parameter descriptions 
Parameter Values Description 
stream OCC Specifies the pre-defined call data stream name for 
(applid) the UCS DMS-250 switch. 
Note: OCC designates a UCS DMS-250 switch. 
volname 20 alphanumeric Specifies the volume name. 
characters 
Note: Volume name may or may not be assigned 
previous to initiating MOUNT. 
nodename string Specifies the file processor name that contains (or 
will contain) the specified volume. 
priority 1 to 18 Specifies the priority level. 
(optional alphanumeric 
command) characters 
—end— 


Example command 


>MOUNT occ dk00occ1 fpo 
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MOUNT (continued) 


Responses 
The following are possible responses to the MOUNT command: 


OPERATION SUCCESSful: 
Volume DRKOOOCC1 has been 
allocated to OCCPOOL. 


Explanation: 

The command has mounted the specified volume to the application’s 
pool in table DRMPOOL. The operation was successful because the 
volume name was 


— entered in the correct format 

— did not already exist in the pool 

— successfully sent to the appropriate FP node 
— available to be used by the DRM 


— able to be owned by the DRM on the FP node (for exclusive 
write access) 


User action: 
None 


Volume DRKOOOCC1 is not available. 
Reason: Specified device does not exist 
Perform Mount operation? (YES/NO, or QUIT): 


Explanation: 
MOUNT failed because the volume: 


— is not mounted 
— is read-only 
— is owned by someone else 


— specified illegal or incorrect pathname or for other reasons that 
may prevent the volume from being used for the application’s 
record data. 


User action: 
Take corrective action to access the volume. The volume status is 
changed by DRM. It is available for recording. 


Error messages 
See “Response” section. 
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MOUNT (end) 


Related commands 
The following are related DRM commands: 


e AUDIT 

e COPY 

e DAT 

e DEMOUNT 
e INFO 

e MONITOR 
e QUIT 

e RENAME 
e RESET 

e ROTATE 

e TCOPY 

e VIEW 
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QUIT (end) 
Purpose 
The Quit (QUIT) command exits the current menu level and returns to a 
previous menu level. 
Access 
>DRM 
Syntax 
>QUIT 
Parameters 
None 


Example command 
None 


Responses 
None 


Related commands 
The following are related DRM commands: 


e AUDIT 

e COPY 

e DAT 

e DEMOUNT 
e INFO 

e MONITOR 
e RENAME 
e RESET 

e ROTATE 

e TCOPY 

e VIEW 
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RENAME 


Purpose 


The Rename (RENAME) command renames a file by changing its file state. 
A file state corresponds to the first character of its name. For example: 
A-Active; U-Unprocessed; P-Processed; R-Removed. 


RENAME allows the following file state transitions: 


- U>PR 
e P>U,R 
e R->U,P 


Restrictions 
Restrictions associated with the RENAME command include: 


e use of this command is not dependent on other datafill tables 


e active files may not be renamed 


Access 

>DRM 
Syntax 

>RENAME stream filetmpl newstate 
Parameters 


Command parameters are described in Table 1-81. 
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RENAME (continued) 


Table 1-81 
RENAME parameter descriptions 


Parameter Values Description 
stream OCC Specifies the pre-defined call data stream name for 
(applid) the UCS DMS-250 switch. 
Note: OCC designates a UCS DMS-250 switch. 
filetmp! string Specifies the file name template. It is made up of the 
first character of a file name followed by any number 
of characters that sufficiently identify one or more 
files. It must begin with “U”, “P”, “R”, or “$”. $ may be 
a wild card for any number of characters in the 
template. If the template is not a complete file name, 
a list of matched names displays. 
newstate Valid values include: New file state. 
U Status is “unprocessed”. 
P Status is “processed”. 
R Status is “removed”. 


—end— 


Example command 


>RENAME occ an90102613 R 
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RENAME (continued) 


Responses 
The following are possible responses to the RENAME command: 


Incorrect <filetmpl> parameter: AN901026 
The parameter must begin with either U, P, or R. 


Explanation: 

A <filetmpl> parameter starting with a character other than U, P, or 
R was entered. Only unprocessed, processed, and removed files may 
be renamed. Active (A) files are always open, and they are 
automatically renamed by the system when they are closed to a name 
that is determined by field CLOSTATE in table DRMAPPL. 


User action: 

Field CLOSTATE may be set in table DRMAPPL to cause active 
files to be named either U, P, or R when they are closed. A ROTATE 
causes the active file to be closed and renamed accordingly. 


OPERATION FAILED: No files match this template in OCC: 
AN90102613 


Explanation: 

The OCC has no files that match this filename template. This is also 
the response format when a specific file cannot be found (when the 
entire filename is supplied). 


User action: 

A less specific template may be used in order to display a list of 
filenames from which to choose. In this case, use RENAME to 
specify another file. For example: 


>RENAME OCC U$901026 R 


would display all files created on 901026 that are in an unprocessed 
(U) state, and may or may not have been copied to the DAT. 
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RENAME (continued) 


OPERATION FAILED: While attempting to rename file: 
UN9010262000430CC to RN90102620000430CC the following file 
system error occurred: 

Input/Output error 


Explanation: 
The rename operation failed due to a file system error. 


User action: 
None 


Note: This response should be taken as a warning that the file 
system is experiencing serious difficulties. The file system error 
message is displayed for diagnostic purposes to help correct the 
problem. 


OPERATION SUCCESSFUL: RB9010261624380CC has been renamed: 
PB901026624380CC 


Explanation: 
The file’s name is changed on disk and the file’s state is changed 
from T (removed) to P (processed in the system). 


User action: 
None 
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RENAME (continued) 


These files match the supplied filename template: 


awk WN EF 


UB9010260000380CC 
UN9010260400380CC 
UN9010260800400CC 
UN9010261200410CC 
UN9010261600420CC 
UN9010262000430CC 


Select a file number (1 TO 6 or QUIT): 


Explanation: 

A request is received to change an “unprocessed” (U) file that was 
created on 901026, to an R (removed) file. If only one U file had 
been created on that data, the file name would have been changed. 
Six files match the request, therefore, a list of the file names is 
displayed so one may be selected to rename. 


The numbers to the left of the file name are used to select the one to 
be renamed. 


User action: 
Enter the number of the file to be renamed, or QUIT to terminate the 
request. 


Error messages 
See “Responses” section. 


Related commands 
The following are related DRM commands: 


AUDIT 
COPY 

DAT 
DEMOUNT 
INFO 
MONITOR 
MOUNT 
QUIT 
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RENAME (end) 


e RESET 

e ROTATE 
e TCOPY 
e VIEW 
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RESET 


Purpose 


The Reset (RESET) command resets the “error” and “rotate” counters 
maintained by DRM per application and per node. 


Restrictions 
Restrictions associated with the RENAME command include: 


e use of this command is not dependent on other datafill tables 


e use of this command causes the specified counters to be reset to 0, 
resulting in the loss of counter values. 


Access 
>DRM 
Syntax 
>RESET stream counter_type desinode 
Parameters 
Command parameters are described in Table 1-82. 
Table 1-82 
RESET parameter descriptions 
Parameter Values Description 
stream OCC Specifies the pre-defined call data stream name for 
(applid) the UCS DMS-250 switch. 


Note: OCC designates a UCS DMS-250 switch. 


counter_type Valid values include: Specifies the type of counter to be reset. 
ERR Specified reset “error” counters only. 
destnode Valid values include: Specifies the node where the counters are to be 
reset. 
ALL Specifies all node counters are reset. 
string Specified node is reset. 
—end— 
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RESET (continued) 


Example command 
>RESET occ rot all 


Responses 
The following are possible responses to the RESET command: 


Issuing this command causes the specified counters to be 
reset to 0, resulting in the loss of the counter values. 


Explanation: 
If counter values are set to 0, their value is lost. 


User action: 
None 


OPERATION SUCCESSFUL: 
Reset OCC ERR counter complete on FPO 


Explanation: 
The resetting of OCC’s error counters on FPO was successfully 
completed. 


User action: 
None 


OPERATION SUCCESSFUL: 
Reset OCC ROT counter complete on FP1 


Explanation: 
The resetting of OCC’s rotate counters on FPO was successfully 
completed. 


User action: 
None 
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RESET (end) 


RESET OCC ROT completed on CM 
RESET OCC ROT completed on FPO 
RESET OCC ROT completed on FP1 


Explanation: 
The resetting of OCC’s rotate counters on all FPs and the CM was 
successfully completed on the three nodes listed. 


User action: 
None 


Error messages 
See “Response” section. 


Related commands 
The following are related DRM commands: 


e AUDIT 

e COPY 

e DAT 

e DEMOUNT 
e INFO 

e MONITOR 
e MOUNT 

e QUIT 

e RENAME 
e ROTATE 

e TCOPY 

e VIEW 
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ROTATE 


Purpose 


The Rotate (ROTATE) command opens a new recording file and closes the 
old one. 


Restrictions 
Restrictions associated with the ROTATE command include: 


e use of this command is not dependent on other datafill tables 


e execution of this command may interfere with the recording throughput 
of the application if the target node has no volumes available for 
recording 


Note: DRM will attempt to perform the rotate to the target node and volume 
specified in the command, and may perform several volume audits on the 
target node to accomplish the rotate. If the rotate is to a volume on the 
current active node and the rotate fails, DRM will attempt to continue using 
the old active file. However, if the application chooses a new active node 
and the rotate fails, DRM must locate the next best volume for the new 
active file. The recovery from a rotate failure may be costly in time and the 
potential exists for an extended pause in the records of the application’s data. 


CAUTION 

Possible loss of service 

Execution of this command may interfere with the 
recording throughput of the application if the target node 
has no volumes available for recording. 


Access 
>DRM 


Syntax 


>ROTATE stream node volume 


Parameters 
Command parameters are described in Table 1-83. 
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ROTATE (continued) 
Table 1-83 
ROTATE parameter descriptions 
Parameter Values Description 
stream OCC Specifies the pre-defined call data stream name for 
(applid) the UCS DMS-250 switch. 
Note: OCC designates a UCS DMS-250 switch. 
node string Specifies the name of the node containing the 
application pool’s volume(s). 
volume 20 alphanumeric Specifies the volume to be rotated. 


characters 


Note: The value entered here may be either a 
volume name or volume number from table 
DRMPOOL. 


—end— 


Example command 


Responses 


>ROTATE occ fp0 


The following are possible responses to the RESET command: 


Downloading parameters ... 


Done. 


Sending Request ... 
>== Request sent +==> 


(Please wait) 
FPO 


Waiting for OCC response 


(30 sec timeout ... 


Explanation: 


The specified node/volume parameters are downloaded to all FPs 
and the CM. The actual rotate request is sent to the current active 
node, where the rotate request is passed on to the OCC software. If 
the OCC software responds within 30 seconds, and ROTATE 
succeeds in creating a new active file, the MONITOR level is entered 
to display the status of the new active file. 


User action: 


Enter MONITOR to display the status of the new active file. 
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ROTATE (end) 


OPERATION FAILED: 
Device Unavailable 


Explanation: 


The specified volume is not available. 


User action: 


Use the INFO command to query the application’s current resources 
and volume status. Determine the reason for the failure or choose an 
alternate volume for to rotate to. 


Error messages 


See “Responses” section. 


Related commands 


The following are related DRM commands: 


AUDIT 
COPY 
DAT 
DEMOUNT 
INFO 
MONITOR 
MOUNT 
QUIT 
RENAME 
RESET 
TCOPY 
VIEW 
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TCOPY 


Purpose 
The Tape Copy (TCOPY) command copies DRM files to a 9-track tape. 
Access 
>DRM 
Syntax 
>TCOPY device stream filetmpl 
Parameters 
Command parameters are described in Table 1-84. 
Table 1-84 
TCOPY parameter descriptions 
Parameter Values Description 
device 0 to 15 Specifies the number of the magnetic tape drive 
where the copied file will be located. 
stream OCC Specifies the pre-defined call data stream name for 
(applid) the UCS DMS-250 switch. 
Note: OCC designates a UCS DMS-250 switch. 
filetmpl string Specifies the file name template. It is made up of the 


first character of a file name followed by any number 
of characters that sufficiently identify one or more 
files. It must begin with “U”, “P”, “R”, or “$”. $ may be 
a wild card for any number of characters in the 
template. If the template is not a complete file name, 
a list of matched names displays. 


—end— 


Example command 
>TCOPY 0 occ u 
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TCOPY (continued) 


Responses 
The following are possible responses to the TCOPY command: 


WRITING File UN920506255000CC 
File written. 


Explanation: 
The first line of the pair of message is written when the writing 
begins. The second line in written when the writing has completed. 


User action: 


None 
Formatting tale ... Format complete. 
Explanation: 
The DRM is formatting the tape for DRM use. The format completed 
successfully. 


User action: 
None 


OPERATION FAILED: Please make sure that a tape is physically 
mounted. 


Explanation: 
A tape is not physically present in the tape drive. 


User action: 
Put a tape in the drive and reissue the command. 


OPERATION FAILED: tape is WRITE PROTECTED. 


Explanation: 
A tape has write protection enabled. 


User action: 
Remove the write protection, remount the tape, and proceed. 
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TCOPY (continued) 


OPERATION FAILED: Tape Drive is in use. 


Explanation: 

A tape is already in use by some other process. Only one process at a 
time can own the tape drive. When at attempt is made to open the 
tape, but another process already has a tape opened in this drive, the 
operation cannot proceed. 


User action: 
Wait until the tape drive is free. 


WRITING File UN90102620000430CC ... Writing failed. 


OP 


OP 


Explanation: 
The tape does not have enough room to accommodate the file being 
written. 


User action: 

Field MAXFDSIZ must be set to 64Mb in table DRMAPPL to limit 
the size of the files if files are routinely copied to 9-track tape. The 
file may be copied to DAT tape instead. 


ERATION FAILED. Copy of active file is not permitted. 


Explanation: 
The user attempted to back up the active file. 


User action: 
Wait until the next ROTATE (this may be forced manually), the copy 
the file to tape. 


ERATION FAILED. No files match the specified template. 


Explanation: 

The user specified an invalid application ID. Since the specified 
application ID has no entry in table DRMAPPL, the request cannot 
be processed. 


User action: 

Re-enter the command specifying a different application ID. If 
necessary, issue a TCOPY command with no other parameters to see 
a list of valid application IDs. 
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TCOPY (continued) 


These files match the supplied filename template: 


awk WN EF 


UB9010260000380CC 
UN9010260400380CC 
UN9010260800400CC 
UN9010261200410CC 
UN9010261600420CC 


U 


B9010262000430CC 


Select a file number or enter QUIT: 


Explanation: 
The user specified a filename template that the system cannot find. 


User action: 
Enter the number of the file to be written to tape, or QUIT to abort 
the operation. 


OPERATION FAILED DUE TO UNEXPECTED TAPE ERROR. 


Explanation: 
An unrecoverable error occurred with the tape or tape drive. The IOC 
file system should generate logs to document the condition. 


Some sort of error has occurred with the tape or the tape drive. 
DRM is unable to circumvent the problem so the request cannot be 
completed. 


User action: 
Check the system log to discover the nature of the problem. 


OPERATION FAILED DUE TO UNEXPECTED TAPE ERROR. 


Explanation: 
An unrecoverable error occurred with the tape or tape drive. The IOC 
file system should generate logs to document the condition. 


Some sort of error has occurred with the tape or the tape drive. 
DRM is unable to circumvent the problem so the request cannot be 
completed. 


User action: 
Check the system log to discover the nature of the problem. 
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TCOPY (continued) 


OPERATION FAILED: While attempting to access file: 
UN9010260400390CC, the following file system error occurred: 
Input/Output error. 


Explanation: 
The 9-track tape operation failed due to a file system error. 


User action: 
None 


CAUTION 

Loss of data 

The tape just mounted for file backup has previously 
been used by the DRM. This, it is likely there are 
billing files already on the tape. Since this operation 
poses the possibility of loss of billing data, the 
operator is queried as to whether the files on the tape 
should be overwritten or if new data files should be 
appended. The option to quit this operation is provided 
in case of operator error. 


The tape just mounted is already labeled as a DRM tape. Do 
you wish to OVERWRITE it? (NO indicates APPEND.) 


OP 


Explanation: 
An unrecoverable error occurred with the tape or tape drive. The IOC 
file system should generate logs to document the condition. 


Some sort of error has occurred with the tape or the tape drive. 
DRM is unable to circumvent the problem so the request cannot be 
completed. 


User action: 

Select one of the following: 

— Yes—OVERWRITE the tape 
— No—APPEND to the tape 

— Quit—ABORT the operation 


ERATION FAILED: Demount operation failed. 
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TCOPY (continued) 


Explanation: 

The tape operation was aborted by either the system or the user after 
the tape was mounted but before any file had been written. An error 
occurred demounting the device. 


User action: 
Examine the log for possible hardware problems. 


The tape just mounted contains the label xxxxxx. Do you want 
to reformat this tape for DRM use? 


Explanation: 

A tape has been mounted that has previously been used by some 
other entity. Important data may be stored on the tape, so the DRM 
prompts for verification before reformatting the tape. 


User action: 
Enter YES for DRM to reformat tape 


OPERATION FAILED: Could not allocate buffer for copying. 


Explanation: 

The DRM was unable to open the disk file for the reading of data for 
file backup. The actual error printed depends on the error that 
occurred. 


User action: 
Examine the error message and system status. Perhaps a disk drive 
was busied during the operation. 


Error messages 
See “Responses” section. 


Related commands 
The following are related DRM commands: 


e AUDIT 

e COPY 

e DAT 

e DEMOUNT 
e INFO 
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TCOPY (end) 


MONITOR 
MOUNT 
QUIT 
RENAME 
RESET 
ROTATE 
VIEW 
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VIEW 
Purpose 
The View (VIEW) command provides a hexadecimal dump of a given file. 
Access 
>DRM 
Syntax 
>VIEW stream filetmpl charcode blocknum 
Parameters 
Command parameters are described in Table 1-85. 
Table 1-85 
VIEW parameter descriptions 
Parameter Values Description 
stream OCC Specifies a pre-defined call data stream name for the 
(applid) UCS DMS-250 switch. 
Note: OCC designates a UCS DMS-250 switch. 
filetmpl string Specifies the file name template. It is made up of the 
first character of a file name followed by any number 
of characters that sufficiently identify one or more 
files. It must begin with “U”, “P”, “R”, or “$”. $ may be 
a wild card for any number of characters in the 
template. If the template is not a complete file name, 
a list of matched names displays. 
charcode Valid values include: Specifies the character code set used in the file. 
AS—ASCII Noite: This entry specifies the code set used in 
translating hex data. 
EB—EBCDIC 
blocknum 1 to 2000000 Specifies the start point for viewing in the file. 


—end— 


Example command 
>VIEW occ un921216002600 as 1 
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VIEW (continued) 


Responses 


The following are possible responses to the VIEW command: 


Block 1: 

0000 |4135 4349 492C 
Te 

0010 |3031 3233 3435 
012345678 9ABCDEF 
0020 |0000 0000 0000 
0030 |6162 6364 6566 
abcdefghijklmnop 
0040 |7172 7374 7576 
0050 |4142 4344 4546 
abcdefghijklmnop 
0060 |5152 5354 5556 
0070 |456E 6420 6F66 
ds 


Block 2: 

0000 |4135 4349 492C 
2% 

0010 |3031 3233 3435 
012345678 9ABCDEF 
0020 |0000 0000 0000 
0030 |6162 6364 6566 
abcdefghijklmnop 
0040 |7172 7374 7576 
0050 |4142 4344 4546 
abcdefghijklmnop 
0060 |5152 5354 5556 
0070 |456E 6420 6F66 
2. 


2062 


3637 


0000 


6768 


7778 
4748 


5758 
2062 


2062 


3637 


0000 


6768 


7778 
4748 


5758 
2062 


6C6F 


3839 


0000 


696A 


797A 
494A 


595A 
6C6F 


6C6F 


3839 


0000 


696A 


797A 
494A 


595A 
6C6F 


636B 2031 
4142 4344 
0000 0000 
6B6C 6D6E 


2E20 
4B4C 


2020 
4D4E 


2E20 
636B 


2032 
4344 
0000 
6B6C 


6D6E 


2E20 
4B4C 


2020 
4D4E 


2E20 
636B 


2020 
2032 


3A20| ASCII, block 


4546| 

0000 | 

6F70 | 

2020| qrstuvwxyz. 
4F50| 

2020| gqrstuvwxuz. 
2E20| End of block 
3A20| ASCII, block 
4546| 

0000| 

6F70 | 

2020 | qrstuvwxyz. 
4F50 | 

2020| grstuvwxuz. 
2E20| End of block 


The numbers in the left-hand column are the hex offsets of the first 


word in each row of the block. 


The display on the right-hand side of the hex dump contains the 
character translation of the dump. Specify whether the file contains 
ASCII or EBCDIC so that the correct translation may be done. 
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VIEW (continued) 


The data is displayed in the same order as it was read from the file; it 
reads left-to-right, and top-down; and in rows of eight hexadecimal 
words for easier legibility. No byte-swapping is done. 


User action: 
None 


The following are possible responses to the VIEW command: 


Block 2894: 


Block 1: 

0000 |C5C2 C3C4 C9C3 6B40 8293 8294 F2F8 F9F4| EBCDID, 
blk 2894 

0010 |FOF1 F2F3 F4F5 F6F7 F8F9 C1C2 C3C4 C5Cé6| 
012345678 9ABCDEF 

0020 |0000 0000 0000 0000 0000 0000 0000 0000| 

0030 |8182 8384 8586 8788 8991 9293 9495 9697| 
abcdefghijklmnop 

0040 |9899 A2A3 A4A5 A6A7 A8A9 4B40 4040 4040| 
qrstuvwxuz. 

0050 |clc2 c3Cc4 C5C6 C7C8 C9D1 D2D3 D4D5 D6D7| 
ABCDEFGHIJKLMNOP 
0060 |D8D9 E2E3 E4E5 E6E7 E8E9 4B40 4040 4040| 
ORSTUVWXYZ. 

0070 |C595 8440 9686 4082 9392 40F2 F8F9 F44B0| 
End of bLK 2849. 


Explanation: 

The “filetmpl” is a valid and complete file name for a file that 
contains at least 2894 128 byte blocks belonging to the OCC 
recording stream. The user specifies that the block contains EBCDIC 
characters, and that only block 2894 should be displayed. 


User action: 
None 


297-2621-819 Standard 14.01 April 2002 


Commands 1-381 


DRM commands 


VIEW (continued) 
These files match the supplied filename template: 
1. UB9010260000380CC 
2. UN9010260400380CC 
3. UN9010260800400CC 
4. UN9010261200410CC 
5. UN9010261600420CC 
5. UB9010262000430CC 


Select a file number (1 to 6, QUIT): 


Explanation: 
The filename template matches six files owned by the OCC. 


User action: 
Enter the number of the file to be viewed, or QUIT to terminate the 
request. 


OPERATION FAILED. No files match this template in OCC: 
UB90102613 


Explanation: 

OCC has no files matching this filename template. This is also the 
response format when a specific file cannot be found (when the 
entire filename is supplied). 


User action: 
None 


Incorrect <filetmpl> parameter: XB901026. 
The parameter must begin with either A, U, P, R, or $, and 
must be < or = 18 characters long. 


Explanation: 
A “filetmpl” variable starting with a character other than A, U, P, R, 
or $ was entered 


User action: 
Re-enter a variable with a valid character. 
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VIEW (continued) 


OPERATION FAILED. While attempting to view file: 
UN9010262000430CC the following file system error occurred: 
Input/Output error. 


Explanation: 
The VIEW operation fails due to a file system error. 


A file system error occurred while trying to read the file. This 
response is displayed and the command is terminated. 


User action: 
None 


OPERATION FAILED. Block 18587 is out of range. File 
UN9010262000430CC has 15902 blocks. 


Explanation: 
The file only has 15902 blocks. 


This input error may only be discovered when the command is 
processed by the DRM system on the FP. This response is displayed 
and the command is terminated. 


User action: 
None 


Error messages 
See “Responses” section. 


Related commands 
The following are related DRM commands: 


AUDIT 
COPY 

DAT 
DEMOUNT 
INFO 
MONITOR 


297-2621-819 Standard 14.01 April 2002 


Commands 1-383 


DRM commands 
VIEW (end) 


MOUNT 
QUIT 
RENAME 
RESET 
ROTATE 
TCOPY 
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EADAS 


Purpose 


Access 


Restrictions 


Syntax 


Parameters 


The UCS DMS-250 switch collects and stores operational measurement 
(OM) data. This data can be polled via a computer such as the engineering 
and administrative data acquisition system (EADAS). The polled data is 
accumulated at EADAS data collection centers. Further analysis of the data, 
at EADAS network management locations, allows network administrators to 
monitor and control network performance in the UCS DMS-250 switch. 


The EADAS commands address two interfaces: data collection 
(EADAS/DC) and network management (EADAS/NM). Both interfaces are 
enabled through software optionality control (SOC). EADAS/DC requires 
SOC UOAMO0001; EADAS/NM requires VOAMO002. 

The EADAS interface commands provide the ability to: 

e collect OM data from the UCS DMS-250 switch 


e analyze and change network performance, such as for surveillance, 
rerouting, reporting, traffic load monitoring, and control capabilities 


All EADAS interface commands are accessed through the command 
interpreter (CI): 


>COMMAND 


Restrictions associated with the EADAS interface commands include: 


e only the OM groups common to the UCS DMS-250 switch are supported 
through the EADAS messages in the standard message set 


e amaximum of 250 trunk groups are supported for network analysis 


For more information on the EADAS interface, see the DMS-100 Family 
EADAS Interface Administration Guide and the DMS-100 Family EADAS 
Interface Translations Guide. 


None. 


None. 
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EADAS (end) 


Example command 
None. 


Responses 
None. 


Related commands 
The following commands are accessible through the EADAS interface: 
e EADASFMT 
e EADASHOW 
e EADASKEY 
e EADSECTS 
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EADASFMT 


Purpose 


The EADASFMT command displays the type of data sent to EADAS. The 
type of data includes the OM group and field names as well as the key name 
for each each record in a section. 


Access 
>EADASFMT 
Syntax 
>EADASFMT class ALL 
>EADASFMT class section_number record 
>EADASFMTT class section_number record_range 
>EADASFMTT class section_number tuple 
>EADASFMTT class section_number tuple_range 
>EADASFMT class section_number ALL 
Parameters 
Table 1-86 describes the command parameters. 
Table 1-86 
EADASFMT parameter descriptions 
Parameter Value Description 
class Valid values: Specifies an accumulation of: 
PREV5M the previous 5 minutes (used for network management) 
CURR5M the current 5 minutes (used for network management) 
EADAS30M 30 minutes 
EADAS60M 60 minutes 
EADAS24 24 hours 
ALL ALL Specifies all occurrences of the preceding parameter 


section_number 


record 


0 through 127 Specifies the section number for which the data is 
displayed 


O through 9999 Specifies the record number within the section for the 
class. The record parameter is valid only if 
section_number is used. The default is all records. 


Note: This parameter requires that the EADAS feature 
Hardware Inventory Freeze be installed. 


—continued— 


297-2621-819 Standard 14.01 April 2002 


Commands 1-387 


EADAS interface commands 
EADASFMTT (continued) 


Table 1-86 


EADASFMT parameter descriptions (continued) 


Parameter 


Value 


Description 


record_range 


tuple 


tuple_range 


0 through 9999 


string 


string 


Specifies a range of records within the section for the 
class. The record_range parameter is valid only if 
section_number is used. The space character delimits the 
from and the to values in the range. 


Note: This parameter requires that the EADAS feature 
Hardware Inventory Freeze be installed. 


Specifies the tuple name within the section for the class. 
The tuple parameter is valid only if section _number is 
used. 


Note: This parameter requires that the EADAS feature 
Hardware Inventory Freeze be installed. 


Specifies a range of tuple names within the section for the 
class. The tuple_range parameter is valid only if 
section_number is used. The space character delimits the 
from and the to strings in the range. 


Note: This parameter requires that the EADAS feature 
Hardware Inventory Freeze be installed. 


—end— 


Example command 


>EADASFMT EADAS30M ALL 
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EADASF\WT (continued) 


Responses 
The following is an example response to the EADASFMT command: 


>EADASFMT EADAS30M ALL 
CLASS: classname PRECISION: single SECTION ID: xxx 


Register 0 Register 1 Register 2 Register 3 . . . up to 33 
registers 
record id groupname groupname groupname 
number fieldname fieldname fieldname 
RECORD ID Key Type Info Type 
0 key of record 0 Info for record 0 
1 key of record 1 Info for record 1 
2 key of record 2 Info for record 2 
13 key of record 13 Info for record 13 


Error messages 


The following error messages may display as a result of the EADASFMT 
command: 


Invalid class. 
Explanation: 
The command contained a non-EADAS class. 


User action: 
Enter the command using an EADAS class. 


Invalid range. 


Explanation: 
The command requested a range of records but the first record is 
larger than the second. 


User action: 
Enter the command with the smaller number of the range listed first. 
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EADASFMT (end) 


Key too large. 


Explanation: 
The command requested a range of records but the second record is 
too large (outside of the total number of records). 


User action: 
Enter the command with a valid record range. 


Related commands 
The following commands are accessible through the EADAS interface: 


e EADSHOW 
e EADASKEY 
e EADSECTS 
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EADASHOW 


Purpose 


The EADASHOW command displays the data in the OM accumulator 
classes. The OM classes are enabled in table OMACC. The EADASHOW 
command is controlled by software optionality control (SOC) UOAMO0001. 


Access 
>EADASHOW 
Syntax 
>EADASHOW class XMIT section_number 
>EADASHOW class ACCUM section_number 
Parameters 
Table 1-87 describes the command parameters. 
Table 1-87 
EADASHOW parameter descriptions 
Parameter Value Description 
class Valid values: Specifies an accumulation of: 
PREV5M the previous 5 minutes (used for network management) 
CURR5M the current 5 minutes (used for network management) 


EADAS30M 30 minutes 
EADAS60M 60 minutes 


EADAS24 24 hours 
XMIT XMIT Specifies display of the data ready for transmission 
ACCUM ACCUM Specifies display of the data accumulated during the 
accumulation period 
section_number O through 127 Specifies the section number for which the data is 
(optional parameter) displayed. Omit the number to display all sections. 
—end— 


Example command 
>EADASHOW EADAS30M ACCUM 
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Responses 


EADASHOW (continued) 
The following is an example response to the EADASHOW command: 
PREAMBLE 
Generic ID: 12 3 
Message type: 67 
Time: 16:00:11 
Date: 97/10/22 
Header lgth: 48 
Option switches: 0 0 0 0 
MEASUREMENT DATA HEADER 
Section ID Precision Section ptr Record lgth Section lgth 
58 1 48 9 4 
60 1. 120 5 1 
100 I 130 3 12 
114 ih 202 33 1 
MEASUREMENT DATA BODY 
SECTION ID: 58 
imd imd imd imd imd 
RecordID ntermatt norigatt Ilmtru termblk origfail 
0 0 0 0 0 0 
T T1 22 1 1 5 
2 0 3 0 0 I 
4 682 744 323 0 17 
imd imd imd 
perclfl stkcoins revert 
0 0 0 
1 0 1 
0 0 0 
0 0 0 
SECTION ID: 60 
machact machact machact machact 
RecordID intlev cplev mtcelev bkgdlev 
0 0 66 85 3549 
SECTION ID: 100 
SECTION ID: 114 
trmtcm trmtrs trmtcm trmtcm trmtcu trmtcm 
RecordID tcmundt trsnosc tcmdil tcmpsig tcuinac tcucndt 
0 0 3 2 0 I I 
trmtcm trmtcu trmtcu trmtrs trmtrs trmtrs 


tcmvact tcumsca tcumslc trsnblh trsemrl trsemr2 


4 1 


Error messages 


il 


0 0 0 


The following error messages may display as a result of the EADASHOW 


command: 
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EADASHOW (end) 


Accumulating data has changed. It cannot be displayed until 
the next accumulation has completed. 


Explanation: 

The command specified ACCUM, but the command occurred during 
the same transfer period in which a section or key was added or 
deleted. 


User action: 
Retry the command after the next accumulation period completes. 


Buffer data has expired and new data is not available until a 
new class accumulation period begins. 


Enter 


Explanation: 
Table OMACC specifies a new accumulation period for a class, or a 
reload and restart has occurred. 


User action: 
Retry the command after the first accumulation period completes. 


an EADAS class. 


Explanation: 
The command contained a non-EADAS class. 


User action: 
Enter the command using an EADAS class. 


Related commands 
The following commands are accessible through the EADAS interface: 


e EADASFMT 
e EADASKEY 
e EADSECTS 
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EADASKEY 


record_number 


0 through 9999 


DELETE DELETE 
tuple string 
ALL ALL 


Purpose 
The EADASKEY command adds tuple keys to or deletes tuple keys from an 
OM group. Each tuple in a section and class is associated with a key. The 
key uniquely identifies the tuple in each OM group. 
Access 
>EADASKEY 
Syntax 
>EADASKEY class section_number ADD record_number 
>EADASKEY class section_number DELETE tuple ALL 
Parameters 
Table 1-88 describes the command parameters. 
Table 1-88 
EADASKEY parameter descriptions 
Parameter Value Description 
class Valid values: Specifies an accumulation of: 
PREV5M the previous 5 minutes (used for network management) 
CURR5M the current 5 minutes (used for network management) 
EADAS30M 30 minutes 
EADAS60M 60 minutes 
EADAS24 24 hours 
section_number 0 through 254 Specifies the section number for the record 
ADD ADD Specifies the inclusion of a record 


Specifies the number of the record within the chosen 
section 


Specifies the deletion of a record 
Specifies the name of the record within the chosen section 


Specifies the deletion of all records within the chosen 
section 


—end— 


Example command 


>EADASKEY EADAS60M 98 ADD 22 
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EADASKEY (end) 


Responses 
The following is an example of the response to the EADASKEY command. 


>EADASKEY EADAS30M 12 DELETE 53 
OK 


Error messages 
The following error messages may display as a result of the EADASHOW 
command: 


>Class format is changing—try again 


Explanation: 
An ADD or DELETE was attempted during a period of data 
accumulation. 


User action: 
Retry the command after the accumulation period completes. 


>Enter integer of string record ID 


Explanation: 
An ADD or DELETE was attempted but lacked a record ID number. 


User action: 
Enter a value for the record ID number. 


>Invalid Class 


Explanation: 
An ADD or DELETE was attempted but lacked an EADAS class. 


User action: 
Enter an EADAS class as the class parameter. 


Related commands 
The following commands are accessible through the EADAS interface: 
e EADASFMT 
e EADASHOW 
e EADSECTS 
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Purpose 


Access 


Syntax 


Parameters 


The Engineering and Administrative Data Sections (EADSECTS) command 
makes changes to sections and group fields in the EADAS interface 
software. These sections and group fields are automatically datafilled when 
a UCS DMS-250 switch is first provisioned. By using the EADSECTS 
command, you can correct datafill errors and modify traffic configuration. 


The EADSECTS command provides the ability to do the following: 


add a section to an EADAS data collection class 

delete a section from an EADAS data collection class 

add group fields to a section 

create the base/extension register association fields in table EADAS 


remove the base/extension register association fields in table EADAS 


CAUTION 

Interface Corruption 

Use the EADSECTS command only if data is being 
incorrectly transmitted to an EADAS data collection 
center. Using the EADSECTS command unnecessarily 
can corruupt the specified DMS EADAS interface. In 
addition, incorrect datafill can corrupt the interface 
between the UCS DMS-250 switch and an EADAS. 


>EADSECTS 


>EADSECTS class section_number ADD precision group field 

>EADSECTS class section_number DELETE 

>EADSECTS class section_number ADDEXT group base field extension field 
>EADSECTS class section_number DELEXT group base field extension field 


Table 1-89 describes the command parameters. 
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Table 1-89 
EADSECTS parameter descriptions 
Parameter Value Description 
class EADAS30M Specifies the literal string name of an EADAS 
EADAS60M class indicating an accumulation of the previous 
EADAS24H 30 minutes, 60 minutes, or 24 hours (used for 
No default value network management). 
section Range: 0 to 254. Specifies the section number. 
No default value 
add No default value Specifies that the section is to be included in the 
EADAS/DC class. 
delete No default value Specifies that the section is to be removed from 
the EADAS/DC class. 
addext No default value Specifies that the association between the base 
field and extension field is to be added. 
delext No default value Specifies that the association between the base 
field and extension field is to be removed. 
precision Range is single or double Specifies the literal string name of an EADAS 
for non-TR compliant precision. 
EADAS interface and 
double for TR compliant 
EADAS interface. 
group No default value Specifies the literal string name of an office OM 
group. 
field No default value Specifies the literal string name of any OM group 
field. 
basefield No default value Specifies the literal string name of any OM group 
base field. 
extfield No default value Specifies the literal string name of any OM group 
associated extension field. 
—end— 
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Example command 


Responses 


The following is an example of the EADSECTS command ADD function: 


>EADSECTS EADAS60M 98 add single tfcana tfanpeg tfcana tfanpeg2 + 
tfcana tfansu tfcana tfansu2 tfcana tfancu tfcana tfancu2 


The following is an example of the EADSECTS command DELETE 
function: 


>EADSECTS EADAS60M 98 delete 


The following is an example of the EADSECTS command ADDEXT 
function: 


>EADSECTS EADAS60M 98 addext tfcana tfanpeg tfanpeg2 tfcana tfansu + 
tfansu2 tfcana tfancu tfancu2 


The following is an example of the EADSECTS command DELEXT 
function: 


>EADSECTS EADAS60M 98 delext tfcana tfanpeg tfanpeg2 tfcana tfansu + 
tfansu2 tfcana tfancu tfancu2 


The following are possible informational or error message responses to the 
EADSECTS command: 


Invalid Class 


Explanation: 
The class parameter entered is an undefined class. 


User action: 
Specify a valid class parameter. 


Must be an EADAS/DC class and have a buffer allocated 


Explanation: 
A non-EADAS class is entered as the class parameter. 
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User action: 
Specify a valid EADAS class parameter. 


ADD function responses 
The following are responses to the ADD function: 


A prompt for a legal section number 


Explanation: 
The section ID number entered is less than 0 or greater than 254. 


User action: 
Specify a valid section number. 


Must enter at least 1 group and field 


Group 


Field 


Field 


Explanation: 
The section specified is valid but an OM group is not specified. 


User action: 
Specify a valid OM group. 


<group name> is invalid 


Explanation: 
The group specified is not in office or is misspelled. 


User action: 


Specify a valid group name. 


name must follow group name 


Explanation: 
The group name is entered without a field name. 


User action: 
Enter group name and field name. 


<field name> is not in group <group name> 
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Explanation: 
The field name does not belong to the group that is entered. 


User action: 
Enter a valid field name for the group that is specified. 


Field from group <group name> can not be added into section 
<id number> 


Explanation: 
A group is entered that is non-compatible with other groups already 
added into the section. 


User action: 
Enter a valid group. 


Can not add more than 128 registers to a section 


Explanation: 
The number of registers entered exceeds the maximum of 128 that 
this specific section has designated. 


User action: 
Enter a valid number of registers that is less than 128. 


DELETE function responses 

The following is a response to the DELETE function: 

Section <id number>is not in class 
Explanation: 


The section ID number entered is not in the class. 


User action: 
Specify a valid section number. 


ADDEXT function responses 
The following are responses to the ADDEXT function: 
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Extension reg association is not valid because section 
precision is not double 


Explanation: 
The precision is entered as single when you are trying to create the 


association. 
User action: 
Specify the precision as double and then create the association. 


Must add at least one group with one base and extension field 


Explanation: 
An OM group is not specified. 


User action: 
Specify a valid OM group with one base and one extension field. 


Invalid group 
Explanation: 


Group name is not a valid group name. 


User action: 
Specify a valid group name. 


Base field name must follow group <group name> 
Explanation: 
The group name is entered without a base field name. 


User action: 
Enter the group name and a base field name. 


Extension field must follow the base field 
Exllanation: 


The base field name is not followed by an extension field name. 


User action: 
Enter the base field name first, followed by the extension field name. 
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Extension reg association not valid because <base field name> 
the base register, was not found in section <section number> 


Explanation: 
The base field is not found within the specified section. 


User action: 
Enter a valid base field for the specified section. 


Extension reg association not valid because <extension field 
name> the extension register, was not found in section 
<section number> 


Explanation: 
The extension field entered does not belong to the specified section. 


User action: 
Enter a valid extension field for the specified section. 


Extension reg association not valid because it already 
exists, no change made 


Explanation: 
The base field already has an association. 


User action: 
None. 


Extension reg association not valid because <base field name> 
is already being used as ext reg for <base field name> 


Explanation: 
The base field is already used as an extension field for another base. 


User action: 
Enter a different base field. 


Extension reg association not valid because <extension field 
name> is already being used as a base reg for <extension reg 
field> 
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Explanation: 
The extension field is already used as a base field. 


User action: 
Enter a different extension field. 


Extension reg association not valid because <extension field 
name> is already being used as ext reg for <base field name> 


Explanation: 
The extension field is already used as an extension field. 


User action: 
Enter a different extension field. 


Extension reg association not valid because reg cannot be 
associatd with itself 


Explanation: 
The reg cannot be associated with itself. 


User action: 
Enter a different base/extension association. 


Use table EADAS to modify the association for dummy registers 


Explanation: 
The dummy field cannot be modified here. 


User action: 
Go to table EADAS to enter the association for dummy registers. 


DELEXT function responses 
The following are responses to the DELEXT function: 


Can not remove base/extension association. Precision needs to 
be DOUBLE 
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Explanation: 
The precision is entered as single when you are trying to remove the 
association. 


User action: 
Specify the precision as double and then remove the base/extension 
association. 


Must add at least one group with one base and extension field 


Explanation: 
An OM group is not specified. 


User action: 
Specify a valid OM group with one base and extension field. 


Invalid group 


Group 


Group 


Explanation: 
Group name is not a valid group name. 


User action: 
Specify a valid group name. 


<group name> is not defined 
Explanation: 
The group name is not a defined group name. 


User action: 
Specify an allocated group name. 


<group name> does not exist in this section 
Explanation: 
The group entered does not belong to the specified section number. 


User action: 
Enter a valid group for the specified section. 


Base field name must follow group <group name> 
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Explanation: 
The group name is entered without a base field name. 


User action: 
Enter the group name and a base field name. 


Extension field must follow the base field 
Explanation: 
The base field name is not followed by an extension field name. 


User action: 
Enter the base field name first, followed by the extension field name. 


Extension reg association not valid because <base field name> 
the base register, was not found in section <section number> 


Explanation: 
The base field is not found within the specified section. 


User action: 
Enter a valid base field for the specified section. 


Extension reg association not valid because <extension field 
name> the extension register, was not found in section 
<section number> 


Explanation: 
The extension field is not found within the specified section. 


User action: 
Enter a valid extension field for the specified section. 


Can not delete the association because it does not currently 
exist 


Explanation: 
The association you are trying to delete does not exist. 


User action: 
None. 
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EADSECTS (end) 


Use table EADAS to modify the association for dummy registers 
Explanation: 
The dummy field cannot be modified here. 


User action: 
Go to table EADAS to enter the association for dummy registers. 


Error Messages 
See ” Responses” section. 


Related commands 
The following commands are accessible through the EADAS interface: 
e EADASFMT 
e EADASHOW 
e EADASKEY 
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FCDRSRCH 


Purpose 


The Flexible Call Detail Record Search (FCDRSRCH) command allows 
entry into the FCDRSRCH directory in order to perform the following 
billing-related activities: 


e select a billing file to be searched 

e initiate a search 

e define keys to compare against data in the call billing record fields 
e set a logical condition among the defined keys 

e impose constraints on the scope of the search 

e view the records that are returned as a result of the search session 


Note: The FCDRSRCH command replaces the CDRSRCH and 
DCDRSRCH commands. 


CDR Management 


Restrictions 


As of UCS13, the FCDRSRCH command no longer supports the following 
CDR fields: 


e PIC 

e TDP 

e TRIGGER 
e RTELIST 
e DCR 


The CDR Management feature does not change any other command or 
functionality. 


For additional information on FCDRSRCH, see the UCS DMS-250 Billing 
Server Application Guide. 


Limitations associated with the FCDRSRCH command syntax include: 


* commands that require one or more parameters are followed by a 
template of the parameter list 


e each parameter in the input line must be separated by blank spaces 


e commands that require non-optional parameters do not take effect until 
all non-optional parameters have been satisfactorily supplied 
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FCDRSRCH (continued) 


Note: The Maintenance and Administration Position (MAP) command 
interpreter requests all non-optional parameters until they are acceptably 
entered. Prompting does not occur for optional parameters unless they 
are optional as a group, and one or more (but not all) have been entered. 


e results of some FCDRSRCH commands are altered by the absence or 
presence of individual or groups of optional parameters when the 
command is invoked 


Access 

>MAPCI;MTC;APPL;OAMAP;FCDRSRCH 
Syntax 

>FCDRSRCH 
Parameters 

None 


Example command 
>FCDRSRCH 


Responses 
None 


Related commands 
The following command(s) are located in the FCDRSRCH directory: 


e BACKUP 

e BLOCK 

e CDRTYPE 

e DISPLAY 

e EXECSRCH 
e FORWARD 

e HELP 

e LISTFLDS 

e NUMOUT 

e NUMSRCH 
e OPERATOR 
e QUIT 
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FCDRSRCH (end) 


e REINIT 

e RSETKEY 
e SETKEY 

e SRCHFIL 

e SRCHSTAT 
e STATUS 

e WINDOW 
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BACKUP 


Purpose 
The BACKUP command allows backward positioning within the output 
buffer from the current position. 


If no parameter is supplied, the output buffer position is reversed by one. If 
an attempt is made to position on an empty output buffer, a message displays 
indicating an invalid request. 


When the BACKUP command is successfully invoked, the output buffer 
record position field of the FCDRSRCH or menu status area is set to the 
difference between the current position number and the supplied value. 


Access 
>MAPCI;MTC;APPL;OAMAP;FCDRSRCH 


Syntax 
>BACKUP pos_backward 


Parameters 
The command parameters are described in Table 1-90. 


Table 1-90 

BACKUP parameter descriptions 
Parameter Values Description 
pos_backward 1... 200 Positive integer 


Example command 
>BACKUP 5 


Responses 
The following are possible responses to the BACKUP command. 
BACKUP SET 


Explanation: 
Acknowledgement indicating that the number to back up is set as 
desired. 


BACKUP SET, POSITION REVERSED BY ONE 
BACKUP SET. 
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BACKUP (continued) 


Explanation: 
No parameter was entered; output buffer position has decreased by 
one. 


CANNOT BACK UP PAST FIRST OUTPUT BUFFER. 
BACKUP SET, DEFAULTED TO FIRST OUTPUT BUFFER. 
BACKUP SET. 


Explanation: 

The value given for the BACKUP command is less than or greater 
than can be accomplished within the output buffer. Output buffer 
position is set at the first CDR in the buffer. 


NO DATA AVAILABLE FOR THE SEARCH 


Explanation: 
No records have been placed in the output buffer by the search. 


User action: 
Redefine search and search again. 


NO DATA IN THE OUTPUT BUFFER. 
NO RECORDS CURRENTLY IN OUTPUT BUFFER 


Explanation: 
A request has been made to view the output buffer even though it has 
not been filled by the search. 


User action: 
Set and perform a search. 


RECORD POINTER ALREADY AT 1st RECORD IN BUFFER 


Explanation: 
Attempt to BACKUP first record in buffer. Buffer position remains 
the same. 


THIS COMMAND IS INHIBITED UNTIL A FILE HAS BEEN OPENED. 
PLEASE USE THE SRCHFIL COMMAND TO OPEN A FILE 


Explanation: 
None of the commands available for FCDRSRCH on disk can be 
used until a billing file is opened. 


User action: 
Use the SRCHFIL command to open a billing file. 
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BACKUP (continued) 


Error messages 


The following error messages may display as a result of the BACKUP 
command. 


BACKUP ERROR !! 


Explanation: 
The command could not be performed because the shared data 
segment was not allocated or was destroyed. 


User action: 


Issue a WARM RESTART. This reinitializes the shared data segment. 
If it does not clear the problem, more memory is needed to support 


the feature, or a restart base is required to reset proper memory 
management. 


INVALID PARAMETER ENTERED. 
BACKUP REQUEST DENIED 


Explanation: 
Parameter could not be recognized. 


User action: 
Enter command again with a valid integer parameter. 


Related commands 
The following commands are related: 


BLOCK 
CDRTYPE 
DISPLAY 
EXECSRCH 
FORWARD 
HELP 
LISTFLDS 
NUMOUT 
NUMSRCH 
OPERATOR 
QUIT 
REINIT 
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BACKUP (end) 


e RSETKEY 
e SETKEY 

e SRCHFIL 

e SRCHSTAT 
e STATUS 

e WINDOW 
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BLOCK 


Purpose 


Access 
Syntax 


Parameters 


The BLOCK command permits you to set the starting block number of the 
selected billing file for the next search session. 


The BLOCK command accepts a required numeric parameter in the range 
indicated in Table 5-91. When a block number is specified that is greater 
than the size of the billing file, a message displays the highest block number 
for the selected billing file. 


The starting block can be set by the SRCHFIL command when the billing 
file is selected for the initial search session. On subsequent search sessions, 
you may use the BLOCK command to alter the initial or default starting 
block. Thus, there is no need to reselect a billing file when the starting block 
is set to an undesirable setting from a previous search session. 


This command updates the current block number field of the FCDRSRCH 
menu status area. 


>MAPCI;MTC;APPL;OAMAP;FCDRSRCH 


>BLOCK block# 


The command parameters are described in Table 1-91. 


Table 1-91 

BLOCK parameter description 
Parameter Values Description 
block# 1 ... 9999999 Positive integer 


Example command 


Responses 


>BLOCK “56723” 


The following are possible responses to the BLOCK command. 


THIS COMMAND IS INHIBITED UNTIL A FILE HAS BEEN OPENED. 
PLEASE USE THE SRCHFIL COMMAND TO OPEN A FILE 
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BLOCK (continued) 


BLOCK 


BLOCK 


BLOCK 


Explanation: 
None of the commands available for FCDRSRCH on disk can be 
used until a billing file is opened. 


User action: 
Use the SRCHFIL command to open a billing file. 


ERROR! ! 


Explanation: 
The shared data segment was not allocated or was destroyed. 


User action: 

A warm restart reinitializes the shared data segment. If it does not 
clear the problem, more memory is needed to support the feature, or 
a restart base is required to reset proper memory management. 


ERROR, BLOCK NUMBER MUST BE SUPPLIED. 
Explanation: 
The block command requires one integer parameter. 


User action: 
Enter the command again. 


NUMBER GIVEN IS GREATER THAN THE NUMBER IN FILE. 


BEGINNING BLOCK NUMBER SET TO LAST BLOCK NUMBER IN FILE 


Explanation: 
Specified block was out of range. The beginning block for the search 
is now the last block in file. 


User action: 
Set search block again. 


INVALID PARAMETER, BLOCK ERROR 


Explanation: 
The block command requires one integer parameter. 


User action: 
Enter the command again. 
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BLOCK (end) 


Related commands 
The following commands are related: 


e BACKUP 

e CDRTYPE 

e DISPLAY 

e EXECSRCH 
e FORWARD 

e HELP 

e LISTFLDS 

e NUMOUT 

e NUMSRCH 
e OPERATOR 
e QUIT 

e REINIT 

e RSETKEY 

e SETKEY 

e SRCHFIL 

e SRCHSTAT 
e STATUS 

- WINDOW 
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CDRTYPE 
Purpose 
The CDRTYPE command changes the record format to search (either CDR 
or OSR). 
Access 
>MAPCI;MTC;APPL;OAMAP;FCDRSRCH 
Syntax 
>CDRTYPE recordtype 
Parameters 
The command parameters are described in Table 1-92. 
Table 1-92 
BLOCK parameter description 
Parameter Values Description 
recordtype CDR or OSR Enter the type of record you wish to 
search. 
Responses 


The following are responses to the CDRTYPE command. 


THE FORMAT SELECTED IS THE XXX 


Explanation: 
XXX is the user selected format. The format selected will be 
examined. 


Error messages 


The following error messages may display as a result of the CDRTYPE 
command. 


INVALID SYMBOL: <cdrtype> {CDR, OSR} 
ENTER: <CDRTYPE> 


Explanation: 
The selected format was not valid. 


User action: 
Reissue the CDRTYPE command with a valid choice. 
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CDRTYPE (continued) 


THIS COMMAND IS INHIBITED UNTIL A FILE HAS BEEN OPENED. 
PLEASE USE THE SRCHFIL COMMAND TO OPEN A FILE 


Explanation: 
None of the commands available for FCDRSRCH on disk can be 
used until a billing file is opened. 


User action: 
Use the SRCHFIL command to open a billing file. 


INCOMPATIBLE INPUT. 
OSR RECORDS ONLY VALID FOR UCSEOPS BILLING STREAM. 


Explanation: 
OSR records are only valid for the UCSEOPS billing stream. 


User action: 
Use the UCSEOPS billing stream to search OSR records. 


Related commands 
The following commands are related: 


e BACKUP 

e BLOCK 

e DISPLAY 

e EXECSRCH 
e FORWARD 

e HELP 

e LISTFLDS 

e NUMOUT 

e NUMSRCH 
e OPERATOR 
e QUIT 

e REINIT 

e RSETKEY 

e SETKEY 
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CDRTYPE (end) 


e SRCHFIL 

e SRCHSTAT 
e STATUS 

¢ WINDOW 
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DISPLAY 


Purpose 


Access 
Syntax 


Parameters 


The DISPLAY command displays the contents of the output buffer. 


If no parameter is supplied, the buffer position returns to the first record in 
the output buffer. When a parameter is supplied, the requested number of 
CDRs displays, beginning with the CDR at the current output buffer 
position. In addition, the output buffer position number is set to the value 
corresponding to the next available CDR in the output buffer. If an attempt 
is made to view an empty output buffer, a message displays indicating an 
invalid request. 


When the DISPLAY command is successfully invoked with a supplied 
parameter, the output buffer position number field of the FCDRSRCH menu 
status area is set to the sum of the current position number and the supplied 
value. 


To avoid time constraints imposed by output to the screen, you may want to 
output to a file and edit. This can be done by issuing the following 


command: 


>SEND SFDEV 
>DISPLAY 
>SEND PREVIOUS 


>MAPCI;MTC;APPL;OAMAP;FCDRSRCH 


>DISPLAY display_rec 


The command parameters are described in Table 1-93. 


Table 1-93 

DISPLAY parameter description 
Parameter Values Explanation and action 
display_rec 1... 200 Positive integer 
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DISPLAY (continued) 


Example command 


Responses 


>DISPLAY 30 


The following are possible responses to the DISPLAY command. 


PARAMETER NOT SUPPLIED 
EVERY CDR IN BUFFER WILL BE DISPLAYED, REGARDLESS OF BUFFER 
POINTER POSITION. 


Explanation: 
Indication that all CDRs in the output buffer will be displayed. 


RECORD NUMBER (record#) 


Explanation: 
This message precedes each record that is displayed from the output 
buffer. 


THE OUTPUT BUFFER IS EMPTY !! 


Explanation: 
Attempt to display CDRs when there are none in the buffer. 


User action: 
Define and perform a search. 


THIS COMMAND IS INHIBITED UNTIL A FILE HAS BEEN OPENED PLEASE 
USE THE SRCHFIL COMMAND TO OPEN A FILE 


Explanation: 
None of the commands available for FCDRSRCH on disk can be 
used until a billing file is opened. 


User action: 
Use the SRCHFIL command to open a billing file. 


*TOP OF OUTPUT BUFFER* 
*END OF OUTPUT BUFFER* 


Explanation: 

These messages may be seen when using the DISPLAY command to 
display records output by a search. They are seen before the first 
record in the output buffer, if it is displayed, and after the last record 
in the output buffer, if it is displayed. 
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DISPLAY (continued) 


Error messages 


The following error messages may display as a result of the DISPLAY 
command. 


INVALID PARAMETER, DISPLAY ERROR 


Explanation: 
Parameter not recognized (may be string instead of numeric). 


User action: 
Enter command again. 


OUTBUFF DATA ERROR 
CBLOCK DATA ERROR 

CDR PRINT ERROR 

SECOND CDR PRINT ERROR 
DISPLAY CDR RECORD ERROR 
OUTBUFF PRINT ERROR 


Explanation: 
This command could not be performed because the shared data 
segment was not allocated or was destroyed. 


User action: 

Issue a WARM RESTART. This reinitializes the shared data segment. 
If it does not clear the problem, more memory is needed to support 
the feature or a restart base is required to reset proper memory 
management. 


Related commands 
The following commands are related: 


BACKUP 
BLOCK 
DISPLAY 
EXECSRCH 
FORWARD 
HELP 
LISTFLDS 
NUMOUT 
NUMSRCH 
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DISPLAY (end) 


e OPERATOR 
e QUIT 

e REINIT 

e RSETKEY 

e SETKEY 

e SRCHFIL 

e SRCHSTAT 
e STATUS 

- WINDOW 
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EXECSRCH 


Purpose 


Access 
Syntax 


Parameters 


The EXECSRCH command initiates each search session. 


EXECSRCH requires no parameters. When invoked, searching begins on 
the selected billing file at the specified or default starting point. Match 
determination is conducted within the default or specified time window for 
the default or specified session duration. If matching is successful, one or 
more CDRs are returned to the output buffer. After you reach a stopping 
condition, a message displays indicating the result of the search session. If 
you attempt to initiate a search session before at least one search key is 
defined, a message displays indicating that searching cannot be performed 
without one or more search keys. 


Note: EXECsrch is not supported when using CDR2AMA3 template. 


To facilitate viewing of the results of a successful search session, the output 
buffer record position status field is set to zero (0) when a stopping 
condition is reached, and at least one CDR is returned. A message indicates 
a successful search or a full output buffer. If a search session is unsuccessful, 
a message displays indicating the reason for the failure and the output buffer 
status field remains blank. Each time this command is invoked, any CDRs 
contained within the output buffer from a previous session are erased and the 
output buffer record position field of the FCDRSRCH menu status area is 
blanked out. 


>MAPCI;MTC;APPL;OAMAP;FCDRSRCH 


>EXECSRCH 


None 


Example command 


Responses 


>EXECSRCH 


The following are possible responses to the EXECSRCH command. 


EOF OR EOM WAS REACHED 
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Explanation: 
The end-of-file marker or end-of-medium marker was reached. 


NO CALL RECORDS WERE ENCOUNTERED 


Explanation: 
The search did not encounter any call records before reaching a 
stopping condition. 


NO CALL RECORDS WERE ENCOUNTERED IN THE SPECIFIED TIME 
WINDOW. 


Explanation: 
The search did not encounter any call records within the specified 
time window. 


User action: 
Reissue the WINDOW command with a time and date corresponding 
to a time window that exists on the billing file. 


THE SEARCH WAS UNSUCCESSFUL! 
NO CALL RECORDS WERE ENCOUNTERED THAT MATCHED THE SEARCH 
KEYS. 


Explanation: 
The search did not encounter any call records that matched the 
specified keys before reaching a stopping condition. 


SEARCH COMPLETE 


Explanation: 
The search is complete. Additional messages indicate if the session 
was successful, and if not, why it was not successful. 


THE SEARCH WAS SUCCESSFUL! 
USE THE STATUS AND DISPLAY COMMANDS TO SEE THE RESULTS. 


Explanation: 
The desired data has been found and returned to the output buffer. 
Records have been placed in the output buffer. 


User action: 
Use the DISPLAY and/or STATUS commands to view the returned 
records. 
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THIS COMMAND IS INHIBITED UNTIL A FILE HAS BEEN OPENED. 
PLEASE USE THE SRCHFIL COMMAND TO OPEN A FILE 


Explanation: 
None of the commands available for CDR search on disk can be used 
until a billing file has been opened successfully. 


User action: 
Use the SRCHFIL command to open a billing file. 


Error messages 


The following error messages may display as a result of the EXECSRCH 
command. 


ERROR: 


ERROR: 


ERROR: 


ERROR: 


ERROR: 


COULD NOT REWIND THE CDR FILE 


Explanation: 

The feature could not rewind the CDR file. This condition occurs if 
the file is corrupted and cannot be searched, or if the device on which 
the file resides is malfunctioning. 


COULD NOT READ A BLOCK FROM THE CDR FILE 


Explanation: 

Could not read from the specified CDR file. This condition occurs if 
the file is corrupted and cannot be searched, or if the device on which 
the file resides is malfunctioning. 


CDR RECORDS OUT OF SYNC IN CURRENT BLOCK 


Explanation: 
The feature detected a recoverable synchronization problem. This 
message is not printed after synchronization is restored. 


DANGEROUS EXTENSION BLOCK THRESHOLD 


Explanation: 
An extension block overflow is eminent and has suspended the 
search so that billing information will not be lost. 


User action: 
Wait until the extension block usage returns to a normal level, then 
reissue the EXECSRCH command. 


DEVICE NOT SUPPORTED FOR CDR SEARCHING 
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EXECSRCH (contin 


ued) 


ERROR: 


ERROR: 


Explanation: 
An attempt has been made to search on a device that cannot be used 
for CDR searching. 


User action: 
Specify the file to search and ensure that it resides on a disk or tape 
volume. 


MISSING FIELD IN CDR FORMAT TYPEDESC 


Explanation: 
The search could not find the requested field in the CDR record. 


User action: 
Check that the datafill for the billing stream is correct and that the 
file specified is from that stream. 


NUM_OF_REC_UNITS OFFICE PARM <=ZERO 


Explanation: 
An office parameter is set to a value that causes a division arithmetic 
overflow. 


User action: 
Determine the table location for the stated office parameter and set it 
to a positive value. 


EXECSRCH ERROR 


Explanation: 

The command cannot be performed because the shared data segment 
has not been allocated or has been destroyed. Issue a WARM 
RESTART. This reinitializes the shared data segment. If it does not 
clear the problem, more memory is needed to support the feature or a 
restart base is required to reset proper memory management. 


FILE PROCESSOR UNAVAILABLE 


INVALI 


Explanation: 

The file processor that contains the file is unavailable due to either a 
restart on the FP or a communications error between the FP and the 
CM. 


D CDR SEARCH RETURN CODE 
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Explanation: 

An invalid return code was sent to the user interface. This only 
happens if the module is not loaded properly, or if the load is 
corrupted. Issue a WARM RESTART and IPL the load again. If not 
successful, a reload restart is required. 


OUTPUT BUFFER FULL 


Explanation: 
The output buffer is completely filled with CDR records. 


SEARCH FAILED 


Explanation: 
The search failed for some reason. An additional message is printed 
indicating the reason for the failure. 


THE SEARCH WAS UNSUCCESSFUL! 


Explanation: 

The desired data was found and no records have been appended to 
the output buffer. An additional message indicates the reason why the 
desired data was not returned. 


ERROR: MEMORY ALLOCATED FAILED FOR CDR OFFSET TABLE 


Explanation: 
FCDRSRCH fails to allocate memory for CDR offset table. 


User action: 
Try command again. 


THIS COMMAND IS INHIBITED UNTIL AT LEAST ONE SEARCH KEY HAS 
BEEN DEFINED. PLEASE USE THE SETKEY COMMAND TO DEFINE SEARCH 
KEYS 


Explanation: 
The feature cannot perform a search session without at least one key 
value. 


User action: 
Use the SETVAL command to specify a key. 


Related commands 
The following commands are related: 


e BACKUP 
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EXECSRCH (end) 


e BLOCK 

e CDRTYPE 
e DISPLAY 

e FORWARD 
e HELP 

e LISTFLDS 
e NUMOUT 
e NUMSRCH 
e OPERATOR 
e QUIT 

e REINIT 

e RSETKEY 
e SETKEY 

e SRCHFIL 

e SRCHSTAT 
e STATUS 

- WINDOW 
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FORWARD 


Purpose 


The FORWARD command allows forward positioning within the output 
buffer from the current position. 


If no parameter is supplied, the output buffer position advances by one. If an 
attempt is made to position on an empty input buffer, a message displays 
indicating an invalid request. 


When the FORWARD command is successfully invoked, the output buffer 
record position field of the FCDRSRCH menu status area is set to the sum of 
the current position number and the supplied value. 


Access 
>MAPCI;MTC;APPL;OAMAP;FCDRSRCH 


Syntax 
>FORWARD pos_forward 


Parameters 
The command parameters are described in Table 1-94. 


Table 1-94 

FORWARD parameter description 
Parameter Values Description 
pos_forward 1 ...200 Positive integer 


Example command 
>FORWARD 
>FORWARD 10 


Responses 
The following are possible responses to the FORWARD command. 
NUMBER FORWARD SET. 


Explanation: 
Acknowledgement indicating that the number to forward is set as 
desired. 
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INCREMENT OUT OF RANGE. 
NUMBER FORWARD SET. 
ADVANCE TO LAST CDR BUFFER. 
NUMBER FORWARD SET. 


Explanation: 

The value given the FORWARD command is less than or greater 
than can be accomplished within the output buffer. The buffer 
pointer is positioned on the last CDR in the buffer. 


NO DATA AVAILABLE FOR THE SEARCH 


Explanation: 
No records have been placed in the output buffer by the search. 


NO DATA IN THE OUTPUT BUFFER 


Explanation: 
A request was made to view the output buffer even though it has not 
been filled by the search. 


NO PARAMETER SPECIFIED. 
NUMBER FORWARD SET. 
ADVANCE OUTPUT BUFFER POSITION BY ONE. 


Explanation: 
No parameter entered with FORWARD command; output buffer 
position advanced by one. 


NUMBER FORWARD SET 


Explanation: 
Acknowledgement indicating that the number to forward is set as 
desired. 


RECORD POINTER CURRENTLY AT LAST RECORD IN BUFFER 


Explanation: 
An attempt was made to advance buffer pointer past the end of the 
current buffer. There is no change in pointer position. 


THIS COMMAND IS INHIBITED UNTIL A FILE HAS BEEN OPENED. 
PLEASE USE THE SRCHFIL COMMAND TO OPEN A FILE 


Explanation: 
None of the commands available for FCDRSRCH on disk can be 
used until a billing file has been opened successfully. 
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User action: 
Use the SRCHFIL command to open a billing file. 


Error messages 


The following error messages may display as a result of the FORWARD 
command. 


FORWARD ERROR! ! 


Explanation: 
The command cannot be performed because the shared data segment 
has not been allocated or has been destroyed. 


User action: 

Issue a WARM RESTART. This reinitializes the shared data 
segment. If it does not clear the problem, more memory is needed to 
support the feature, or a restart base is required to reset proper 
memory management. 


INVALID PARAMETER ENTERED. 
FORWARD REQUEST DENIED. 


Explanation: 
An attempt has been made to supply a string as the number to 
forward. 


User action: 
Reissue the FORWARD command and supply a numeric value. 


INCREMENT OUT OF RANGE. 

NUMBER FORWARD SET. 

ADVANCE TO LAST RECORD OF BUFFER. 
NUMBER FORWARD SET. 


Explanation: 
The increment is out of range. 


User action: 
Advance to the last record of the buffer. 


Related commands 
The following commands are related: 


e BACKUP 
e BLOCK 
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FORWARD (end) 


e CDRTYPE 

e DISPLAY 

e EXECSRCH 
e HELP 

e LISTFLDS 

e NUMOUT 

e NUMSRCH 
e OPERATOR 
e QUIT 

e REINIT 

e RSETKEY 

e SETKEY 

e SRCHFIL 

e  SRCHSTAT 
e STATUS 

e WINDOW 
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Purpose 


Access 
Syntax 


Parameters 


Use HELP to display the valid FCDRSRCH commands when using the 
NODISP option. 


The NODISP option allows you to enter the FCDRSRCH level of MAPCI. 
This option turns off the MAPCI window formatting, thus freeing the entire 
MAP screen space for displaying CDRs. The drawback to NODISP is that 
all MAPCI displayed menus and information fields are lost. The HELP 
command allows you to display the valid FCDRSRCH commands. 


The HELP command is a hidden command and does not show in the 
command menu at the OAMAP level of MAPCI. 


>MAPCI;MTC;APPL;OAMAP;FCDRSRCH 


>HELP 


None 


Example command 


Responses 


>HELP 


The following are possible responses to the HELP command. 


FCDRSRCH HELP MENU - FOR DETAILED INFORMATION ON ANY OF THE 
FOLLOWING COMMANDS ENTER Q <COMMAND>. 
FOR EXAMPLE: Q <SRCH> 


SRCHfil: Select a billing file for searching. 

CDRtype: Select the type of records to search. 

LISTfields: List all valid field names for the selected 
CDRTYPE. 

SETkey: Define a search key or list the defined keys. 

RSETkey: Edit the current search key definitions. 

OPERator: Toggle the current search key logical operator 
from AND to OR; or from OR to AND. 

WINDow: Define the time window for searching. 

BLOCk: Select a starting block within the selected 


billing file for the nect search session. 
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NUMSrch: Set the number of records to search for the next 
search session. 

NUMout : Set the number of records tooutput for the next 
search session. 

STATus: Display additional search information not 
covered in the status area. 

REINit: Re-initialize all non-search key parameters. 


Search keys modified by SETkey and RSETkey. 
Parameters may be modified individually. 


FORWard: Position forward within the output buffers. 
BACKup: Position backwards within the output buffers. 
DISPlay: Print records from the current position within 
the output buffer. 
EXECsrch: Initiate a search session. 
HELP: This display. 
SRCHSTat: FCDRSRCH status area information displayed to 
the MAP screen. 
Explanation: 
This is the information detailed menu that is displayed when using 
the HELP command. 


The following is the output text that is generated when using the HELP 
command as above. 


>q quit 
Parameter is: < nlevels | incrname ALL > 
>q srchfil 
SRCHFIL: Select a billing file for searching 
AUTO MODE: 
Stream — (AMA, OCC) 
DIRP state - (ACTive or PARallel) 
Block # - 1 TO 9999999 
MANUAL MODE: 
Filename - Billing file name 
- FTFS syntax ::FP#/<volume>/<filename> 
- IOC syntax <filename> 
Format — Record format (from table CRSFMT) 
Block # - 1 TO 9999999 


- up to 7 digits in quotes 
Parms: <Stream/Filename> STRING 
<Dirpstate/Format> {ACT, 
ACTIVE, 
PAR, 
PARALLEL, 
(otherwise) } 
[<Beginning block #> {1 TO 9999999}] 
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>q cdrtype 
CDRTYPE : Select the type of records to search. 
Parms: <Cdrtype> {CDR, 

OSR} 


>q listflds 
LISTFLDS: List all valid field names for the 
selected CDRTYPE. 


>q setkey 
SETKEY: Define a search key or list the defined keys 
No parms —- List all defined search keys 
Optnl parms - Record field name 
Record field data value 


Parms: [<Record field name> STRING] 
[<Record field data value (in quotes)> STRING] 


>q rsetkey 
RSETKEY: Edit the current search key definitions 


No parms - Erase all currently defined search keys 

One parm - (Field name) Erase the keys which have the 
supplied record field name 

Two parms - (Field name, Field value) Erase the keys which 


have the supplied value name and value 
Parms: [<Record field name> STRING] 
[<Record field data value (in quotes)> STRING] 


>q operator 
OPERATOR: Toggle the current search key logical operator 
from AND to OR; or from OR to AND. 
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>q window 
WINDOW: Define the time window for searching. 


No parms Set the time window to default 
First parm group - Beginning time: YYYY MM DD HH MM 
Second parm group - Ending time: YYYY MM DD HH MM 
NOTE: 


Backward time changes may cause inaccuracies in 

time window determination. To ensure totally correct 
results on files which contain a backward time change 
use the default time window. 

Parms: [<Begin year> {1976 TO 9999}] 

[<Begin month> {1 TO 12}] 

[<Begin day> {1 TO 31}] 

[<Begin hour> {0 TO 23}] 

[<Begin minute> {0 TO 59}] 

[<End year> {1976 TO 9999}] 

[<End month> {1 TO 12}] 

[<End day> {1 TO 31}] 

[<End hour> {0 TO 23}] 

[<End minute> {0 TO 59}] 


>q block 
BLOCK: Select a starting block within the selected 
billing file for the next search session. 
Block number - (Range 1 TO 9999999) 

- Up to 7 digits in quotes 
Parms: <Block number> {1 TO 9999999} 


>q numsrch 
NUMSRCH: Set the number of records to search 
for in the next search session. 


Number of records - (Range 1 to 9999999) 
- Up to 7 digits in quotes 
Default (no parameter): search all records 


Parms: [<Number of records> {1 TO 9999999}] 


>q numout 
NUMOUT: Set the number of records to output 
for the next search session. 


Number of records - (Range 1 to 200) 
Default (no parameter): output all matched records 
Parms: [<Number of records> {1 TO 200}] 


297-2621-819 Standard 14.01 April 2002 


Commands 1-437 


FCDRSRCH commands 
HELP (continued) 


>q status 
Display additional search information not covered in the 
status area 


>q reinit 

REINIT: Re-initialize all non-search key parameters. 
Search keys modified by SETKEY and RSETKEY. 
Parameters may be modified individually. 
For more information, see FCDRSRCH menu. 


>q forward 

FORWARD: Position forward within the output buffers. 
Number of entries- (Range 1 to 200) 

Default (no parameter): FORWARD 1 


Parms: [<Number of entries> {1 TO 200}] 

>q backup 

BACKUP: Position backwards within the output buffer. 
Number of entries (Range 1 to 200) 

Default (no parameter): BACKUP 1 

Parms: [<Number of entries> {1 TO 200}] 

>q display 


DISPLAY: Print records from the current 
position within the output buffer. 


Number of entries (Range 1 to 200) 
Default (no parameter): All records in buffer 
Parms: [<Number of entries> {1 TO 200}] 


>q execsrch 
EXECSRCH : Initiate a search session. 


Related commands 
The following commands are related: 


e BACKUP 

e BLOCK 

e CDRTYPE 

e DISPLAY 

e EXECSRCH 
e FORWARD 
e LISTFLDS 

e NUMOUT 
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e NUMSRCH 
e OPERATOR 
e QUIT 

e  REINIT 

e RSETKEY 

e SETKEY 

e SRCHFIL 

e SRCHSTAT 
e STATUS 

e WINDOW 
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LISTFLDS 
Purpose 
The List Fields (LISTFLDS) command provides a list of all billing record 
fields that pertain to the call record format for the selected billing file. It lists 
the names and correct spelling of the billing record fields to assist in 
defining search keys. LISTFLDS requires no parameters and has no effect 
upon the FCDRSRCH menu status area. 
Once a file is opened, its billing format is known to the system and the 
appropriate fields are displayed. 
Access 
>MAPCI;MTC;APPL;OAMAP;FCDRSRCH 
Syntax 
>LISTFLDS 
Parameters 
None 


Example command 
>LISTFLDS 


Responses 


This command is inhibited until a file has been opened. Use the SRCHFIL 
command to open a file, as shown in the following example and response. 


>SRCHFIL 
>LISTFLDS 
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VALID CDR FIELDS ARE: 

RECCD, TEMPLID, TOOLGEN, SEQNUM, CIC, ORIGDATE, ANSTYPE, 
DISCDATE, ANISUFF, INCBILL, CALLDUR, PINDIGS, ANISP, BILLNUM, 
ACCTCD, CLGPTYNO, RLTCDR, ACCTV, UNIVACC, DIALEDNO, CALLEDNO, 
OUTPULNO, ORIGOPRT, OPART, TPART, RTELIST, RTENO, EXOPCH, 
COLLTIME, ADIN, NUMWBCKT, WBCKTS, FINSID, BILLTYPE, ORIGGRP, 
DISCTYPE, ORIGMEM, PASSTHRU, TERMGRP, PRESIND, TERMMEM, 
FINTKGRP, FINTKMEM, SCPBILL, TDP, PIC, TRIGGER, COMPCODE, 
CRID, STS, PREDIG, ACG, ADDRNUM, ANSCDR, CAINCT, CALLTYPE, 
CDRALGOR, CLDNOA, CLGNOA, CNPREDIG, COSINDEX, COSOVE, DCR, 
DIALNOA, DIGDATA, DISCAMPM, DISCTIME, DNIS, DNISOA, FILL1, 
FILL2, FILL4, INCINTL, INFODIG, MLTCOSID, NETOPNO, NETOPNOA, 
NETSEC, NUMADDRS, ORIGAMPM, ORIGECHO, ORIGLRN, ORIGPVN, 
ORIGSTS, ORIGTIME, OSRASSOC, OTPULNOA, OVERFLOW, QUEUED, 
RELCAUSE, REORGCTR, RTETAB, SUBRIDX1, SUBRIDX2, SUBRLOG1, 
SUBRLOG2, SUBRNUM1, SUBRNUM2, SUBRTYP1, SUBRTYP2, SUBRVAL1, 
UBRVAL2, TERMECHO, TERMLRN, TERMPVN, TIMECHNG, TRAP, 
RTMTCD, FILL3, FILL8, CARRSEL, LNPCHECK, PORTEDNO< OUTNOA, 
ICCASU, CICORIGN, CN1REQ, CN2REQ, CNITREQ, CN2TREQ, CN3REQ, 
NTOTREQ, CN3TREQ, ECRM1, ECRM2, ECRN1, ECRN2, RTEINDEX, 
RJCODE, SLPID, AMASC, AMACALLC, TIMEGARD, CALLEVTS, TRKGRP, 
NICPN, DLPRESUB, LATA, AMAMOD1, AMAMOD2, PARTYID, LRNSRCID, 
RYSTIND, DISCYEAR, DISC1OTH, ORIGYEAR, ORIGI1OTH, ALTBILL, 
MACALLT, SVCFTR, ROUTIND, COMPCODE2, HEXID, TRMOSEAS, 
PERINV, MODMAP, DIGIDTRN, DIGIDJIP, DIGIDNPA, OACESID, BAF, 
MASIZE, AMABAFMD, TERMPLAN, ORIGPLAN, EXOSEAS 


Gl 
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The following are possible responses to the LISTFLDS command. 


THIS COMMAND IS INHIBITED UNTIL A FILE HAS BEEN OPENED. 
PLEASE USE THE SRCHFIL COMMAND TO OPEN A FILE 


Explanation: 
None of the commands available for FCDRSRCH on disk can be 
used until a billing file has been opened successfully. 


User action: 
Use the SRCHFIL command to open a billing file. 


VALID CDR FIELDS ARE: (list of valid fields for given 
format) 


Explanation: 
This message displays the names of the fields in the current billing 
format. 
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LISTFLDS (end) 


User action: 
Use the SETKEY command to specify the fields restricting the 
search. 


Related commands 
The following commands are related: 


e BACKUP 

e BLOCK 

e CDRTYPE 

e DISPLAY 

e EXECSRCH 
e FORWARD 

e HELP 

e NUMOUT 

e NUMSRCH 
e OPERATOR 
e QUIT 

e REINIT 

e RSETKEY 

e SETKEY 

e SRCHFIL 

e SRCHSTAT 
e STATUS 

- WINDOW 
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NUMOUT 
Purpose 
The NUMOUT command provides an optional search constraint. This 
constraint limits the duration of a search session to the number of operations 
necessary to return a specific number of matched call detail records (CDR) 
to the output buffer. 
Access 
>MAPCI;MTC;APPL;OAMAP;FCDRSRCH 
Syntax 
>NUMOUT rec_output 
Parameters 
The command parameters are described in Table 1-95. 
Table 1-95 
NUMOUT paramater description 
Parameter Values Description 
rec_output 1... 200 Positive integer; the default of no limit on the number to output 


applies when NUMOUT is not invoked without a supplied 
parameter. The default is active when the number of records to 
output field of the FCDRSRCH menu status area contains “all.” 


The status field is updated with the supplied value when NUMOUT is 
successfully invoked with a parameter. 


Example command 
>NUMOUT 5 


Responses 
The following are possible responses to the NUMOUT command. 


NO PARAMETER SUPPLIED, NUMOUT SET. 
ALL RECORDS WILL BE OUTPUT. 


Explanation: 
Indication that the search is not constrained by the number of records 
output (unless the output buffer is filled). 
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NUMOUT (continued) 


NUMBER OF RECORDS TO OUTPUT INVALID. 


Explanation: 
The value supplied with the NUMOUT command is invalid. Reissue 
the command with a legal value. 


NUMOUT SET. 


Explanation: 
Acknowledgement indicating that the number to output is set as 
desired. 


NUMBER TO OUTPUT EXCEEDS THE NUMBER TO SEARCH. 


Explanation: 

The value supplied with the NUMOUT command is greater than the 
number requested to search. The feature cannot output more records 
than it encounters. 


User action: 
Reissue the command with a smaller value. 


THIS COMMAND IS INHIBITED UNTIL A FILE HAS BEEN OPENED. 
PLEASE USE THE SRCHFIL COMMAND TO OPEN A FILE. 


Explanation: 
None of the commands available for FCDRSRCH on disk can be 
used until a billing file has been opened successfully. 


User action: 
Use the SRCHFIL command to open a billing file. 


Error messages 


The following error messages may display as a result of the NUMOUT 
command. 


EITHER INCORRECT OPTIONAL PARAMETER(S) ENTERED OR TOO MANY 
PARAMETERS. 

INVALID PARAMETER ENTERED. 

NUMOUT REQUEST DENIED. 


Explanation: 
Attempt was made to enter a string value for an out of range number 
to output, or an unrecognizable parameter was entered. 
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NUMOUT (continued) 


NUMBER OF RECORDS TO OUTPUT ... 


User action: 
Enter the command again. 


ERROR 


Explanation: 
An attempt was made to supply a string as the number to output. 


User action: 
Reissue the NUMOUT command and supply a numeric value. 


NUMOUT ERROR! ! 


Explanation: 


The command cannot be performed because the shared data segment 


has not been allocated or has been destroyed. 


User action: 
Issue a WARM RESTART. This reinitializes the shared data 


segment. If it does not clear the problem, more memory is needed to 


support the feature, or a restart base is required to reset proper 
memory management. 


Related commands 
The following commands are related: 


BACKUP 
BLOCK 
CDRTYPE 
DISPLAY 
EXECSRCH 
FORWARD 
HELP 
LISTFLDS 
NUMSRCH 
OPERATOR 
QUIT 
REINIT 
RSETKEY 
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NUMOUT (end) 


SETKEY 
SRCHFIL 
SRCHSTAT 
STATUS 
WINDOW 
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NUMSRCH 


Purpose 


The NUMSRCH command provides the optional search constraint that 
limits the duration of a search session to the number of operations necessary 
to search a specific number of CDRs within the billing file. This number can 
be up to 9999999. The FTFS file system allows for files larger than 64 
Mbytes. 


The default of no limit on the number to search applies when NUMSRCH is 
not invoked or is invoked without a supplied parameter. The default is active 
when the number of records to search field of the FCDRSRCH menu status 
area contains “all.” 


The status field is updated with the supplied value when NUMSRCH is 
successfully invoked with a parameter. 


Access 
>MAPCI;MTC;APPL;OAMAP;FCDRSRCH 
Syntax 
>NUMSRCH rec_search 
Parameters 
The command parameters are described in Table 1-96. 
Table 1-96 
NUMSRCH parameter description 
Parameter Values Description 
rec_search 1 ... 9999999 Positive integer; numbers smaller than 32767 


ALL Default value; the search continues until some other 
search-halting criteria is met. 


Example command 


Responses 


>NUMSRCH “82364” 


The following are possible responses to the NUMSRCH command. 


THIS COMMAND IS INHIBITED UNTIL A FILE HAS BEEN OPENED. 
PLEASE USE THE SRCHFIL COMMAND TO OPEN A FILE 
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Explanation: 
None of the commands available for FCDRSRCH on disk can be 
used until a billing file has been opened successfully. 


User action: 
Use the SRCHFIL command to open a billing file. 


NO PARAMETER SUPPLIED, NUMSRCH SET. 
SEARCH ALL RECORDS 


Explanation: 
Indicates that the search is not constrained by the number of records 
searched. 


NUMBER TO SEARCH LESS THAN NUMBER TO OUTPUT. 


Explanation: 
The value supplied with the NUMSRCH command is invalid. 


User action: 

Reissue the command with a legal value. The number of records to 
search must always be greater than or equal to the number of records 
to output. 


NUMSRCH SET 


Explanation: 
Acknowledgement indicating that the number to search has been set 
as desired. 


Error messages 


The following error messages may display as a result of the NUMSRCH 
command. 


EITHER INCORRECT OPTIONAL PARAMETER(S) OR TOO MANY 
PARAMETERS . 

INVALID PARAMETER ENTERED. 

NUMSRCH REQUEST DENIED. 


Explanation: 
An attempt was made to supply a string value for an out of range 
number as the number to search, or an invalid string was entered. 


User action: 
Reissue the NUMSRCH command and supply a numeric value. 
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NUMSRCH (end) 


NUMSRCH ERROR 


Explanation: 
The command cannot be performed because the shared data segment 
has not been allocated or has been destroyed. 


User action: 

Issue a WARM RESTART. This reinitializes the shared data 
segment. If it does not clear the problem, more memory is needed to 
support the feature, or a restart base is required to reset proper 
memory management. 


Related commands 
The following commands are related: 


e BACKUP 

e BLOCK 

e CDRTYPE 

e DISPLAY 

e EXECSRCH 
e FORWARD 

e HELP 

e LISTFLDS 

e NUMOUT 

e OPERATOR 
e QUIT 

e REINIT 

e RSETKEY 

e SETKEY 

e SRCHFIL 

e SRCHSTAT 
e STATUS 

- WINDOW 
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Purpose 


Access 
Syntax 


Parameters 


The OPERATOR command toggles the logical condition imposed among the 
defined search keys. 


When invoked, the logical condition for the search session is changed to the 
value opposite from the current setting. The two states for the logical 
condition are AND and OR. Therefore, this command changes AND to OR 
and OR to AND. If this command is not invoked, the search keys are 
ANDed since AND is the default value upon entering the FCDRSRCH MAP 
level. 


>MAPCI;MTC;APPL;OAMAP;FCDRSRCH 
>OPERATOR 


None 


Example command 


Responses 


>OPERATOR 


The following are possible responses to the OPERATOR command. 


OPERATOR SET, VALUE TOGGLED 


Explanation: 
Indication that the logical operator for the search keys has been 
toggled. 


THIS COMMAND IS INHIBITED UNTIL A FILE HAS BEEN OPENED 
PLEASE USE THE SRCHFIL COMMAND TO OPEN A FILE 


Explanation: 
None of the commands available for FCDRSRCH on disk can be 
used until a billing file has been opened successfully. 


User action: 
Use the SRCHFIL command to open a billing file. 
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Error messages 


The following error messages may display as a result of the OPERATOR 
command. 


OPERATOR ERROR !! 


Explanation: 
The command cannot be performed because the shared data segment 
has not been allocated or has been destroyed. 


User action: 

Schedule a WARM RESTART. This reinitializes the shared data 
segment. If it does not clear the problem, more memory is needed to 
support the feature or a restart base is required to reset proper 
memory management. 


Related commands 
The following commands are related: 


e BACKUP 
e BLOCK 

e CDRTYPE 
e DISPLAY 

e EXECSRCH 
e FORWARD 
e HELP 

e LISTFLDS 
e NUMOUT 
e NUMSRCH 
e QUIT 

e REINIT 

e RSETKEY 
e SETKEY 

e SRCHFIL 

e SRCHSTAT 
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OPERATOR (end) 


e STATUS 
e WINDOW 
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QUIT 

Purpose 
Use the QUIT command to exit from the current menu level and return to a 
previous menu level. Quiting from the FCDRSRCH level of the map closes 
the opened file and erases any CDRs in the display buffer. 

Access 
>MAPCI;MTC;APPL;OAMAP;FCDRSRCH 

Syntax 
>QUIT 

Parameters 
None 


Example command 


>QUIT 
Responses 
The following are possible responses to the QUIT command. 
CI: 
Explanation: 
The system exited all MAP menu levels and returned to the CI level. 
QUIT -- Unable to quit requested number of levels. Last 


parameter evaluated was: 1 


Explanation: 
An invalid level number was entered. The number entered exceeds 
the number of MAP levels from which to quit. 


User action: 
Enter the command again using the correct level number. 


Related commands 
The following commands are related: 


e BACKUP 
e BLOCK 

e CDRTYPE 
e DISPLAY 
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QUIT (end) 


EXECSRCH 
FORWARD 
HELP 
LISTFLDS 
NUMOUT 
NUMSRCH 
OPERATOR 
QUIT 
REINIT 
RSETKEY 
SETKEY 
SRCHFIL 
SRCHSTAT 
STATUS 
WINDOW 
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REINIT 

Purpose 
The REINIT command reinitializes all search parameters currently defined 
with the exception of the search keys. When you execute the REINIT 
command, all CDR data in the buffer is erased. Also, the current block 
number and time window for the last search are reset to 0. 

Access 
>MAPCI;MTC;APPL;OAMAP;FCDRSRCH 

Syntax 
>REINIT 

Parameters 


No parameters are required for this command. A yes/no prompt is displayed 
for safety. Each of the parameters can be reset individually by using other 
FCDRSRCH commands. 


Example command 
>REINIT 


Responses 
The following are possible responses to the REINT command. 


THE REINIT COMMAND DOES NOT AFFECT THE SEARCH KEYS, BUT DOES 
REINITIALIZE ALL OTHER SEARCH PARAMETERS. DO YOU WANT TO 
RESET THIS INFORMATION? 

PLEASE CONFIRM (“YES”, “Y”, “NO”, “N”): 


Explanation: 
Informs of the consequences of the REINIT command and allows a 
chance to reconsider. 


User action: 
Respond to this prompt before continuing. 


THIS COMMAND IS INHIBITED UNTIL A FILE HAS BEEN OPENED. 
PLEASE USE THE SRCHFIL COMMAND TO OPEN A FILE 


Explanation: 
None of the commands available for FCDRSRCH on disk can be 
used until a billing file has been opened successfully. 


User action: 
Use the SRCHFIL command to open a billing file. 
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Error messages 


The following error messages may display as a result of the REINT 
command. 


REINIT DENIED, NO CHANGES MADE 


Explanation: 
A response not to reinitialize search parameters was entered. 


REINIT ERROR !! 


Explanation: 
The command cannot be performed because the shared data segment 
has not been allocated or has been destroyed. 


User action: 

Issue a WARM RESTART. This reinitializes the shared data segment. 
If it does not clear the problem, more memory is needed to support 
the feature, or a restart base is required to reset proper memory 
management. 


Related commands 
The following commands are related: 


e BACKUP 

e BLOCK 

e CDRTYPE 

e DISPLAY 

e EXECSRCH 
e FORWARD 

e HELP 

e LISTFLDS 

e NUMOUT 

e NUMSRCH 
e OPERATOR 
e QUIT 

e RSETKEY 

e SETKEY 
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REINIT (end) 


e SRCHFIL 

e SRCHSTAT 
e STATUS 

¢ WINDOW 
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RSETKEY 


Purpose 


Access 


Syntax 


Parameters 


The Reset Key (RSETKEY) command is used to reset search keys. It allows 
the user to edit the current search key definitions. The parameters are the 
same as the SETKEY command, except each parameter is optional. The 
RSETKEY command is used to reset a CDR search qualifier previously set 
with the SETKEY command. 


If you attempt to erase a key that does not exist, a message displays 
indicating an invalid request. Edit the defined search keys using the 
SETKEY and RSETKEY commands. If a defined key is undesirable, you 
must erase it with the RSETKEY command, then redefine the key using the 
SETKEY command. 


The RSETKEY command only erases search keys. Search key values cannot 
be altered once defined. If a different key is desired, the old key must be 
erased and a new key defined. 


>MAPCI;MTC;APPL;OAMAP;FCDRSRCH 


The following three variations of the RSETKEY command are allowed: 


e All search parameters are cleared if no parameters are supplied with the 
RSETKEY command. 


e All search key qualifiers are cleared for the specified key if only the key 
name is supplied as a parameter to the RSETKEY command. 


e A specific search key is cleared if both the search key and search value 
are supplied as parameters to the RSETKEY command. 


>RSETKEY 
>RSETKEY <CDR field> 
>RSETKEY <CDR field> <value> 


The command parameters are described in Table 1-97. 


Digital Switching Systems UCS DMS-250 Commands Reference Manual UCS17 


1-458 Commands 


FCDRSRCH commands 
RSETKEY (continued) 


Table 1-97 
RSETKEY parameter descriptions 
Parameter Values Description 
CDR field Up to 8-character Optional; CDR field name as shown by the result of the 
field name LISTFLDS command 
value Up to 16-character Optional; pertinent to the desired CDR field 
string 
TRMOSEAS 0 to9 International Call Indicator 
OPERINV 0to9 Operator Involvement Indicator 
ROUTIND O0to5 IC/INC Routing Indicator 
COMPCODE2 0 to 999 Completion Indicator 
MODMAP 0 to 999 Module Code 
AMACALLT 0 to 999 Translation Settable Field 1 
SVCFTR 0 to 999 Translation Settable Field 2 
TERMPLAN N/A RESERVED for future use 
ORIGPLAN 
EXOSEAS 


This command has no effect upon the FCDRSRCH menu status area. 


Example command 


Responses 


>RSETKEY ‘Y’ 
>RSETKEY EXOPCH 
>RSETKEY EXOPCH ‘171’ 


The following are possible responses to the RSETKEY command. 


FIELD NAME AND DATA VALUE SUPPLIED. 

REMOVING THE KEYS WHICH HAVE THE SUPPLIED FIELD AND DATA 
VALUES. 

DO YOU WANT TO CONTINUE? 

PLEASE CONFIRM (“YES”, “Y”, “NO”, “N”): 


Explanation: 
These messages appear in response to the valid RSETKEY options 
selected. 


297-2621-819 Standard 14.01 April 2002 


Commands 1-459 


FCDRSRCH commands 
RSETKEY (continued) 


User action: 
Respond to the Y/N prompt before continuing. 


FIELD NAME SUPPLIED, ERASE THE KEYS WHICH HAVE THE SUPPLIED 
RECORD FIELD NAME. 

DO YOU WANT TO REMOVE THIS INFORMATION? 

PLEASE CONFIRM (“YES”, “Y”, “NO”, “N”): 


Explanation: 
These messages appear in response to the valid RSETKEY options 
selected. 


User action: 
Respond to the Y/N prompt before continuing. 


CDR INDEX NOT FOUND SETVAL. 

CLLI NOT FOUND IN DATA DICTIONARY. 

KEY DOES NOT MATCH BCD FORMAT. 

INVALID CDR FIELD INPUT. 

FIELD NOT FOUND IN THE CDR. 

THE VALID FIELDS ARE (list of valid fields) 


Explanation: 
An attempt has been made to set up a search key that does not match 
a field in the CDR record format. 


User action: 
Reissue the SETKEY command using a legal field name. 


INPUT INCORRECT 
Explanation: 
The data item supplied using the SETKEY command is not a string. 


User action: 
Reissue the command and enclose the data item within single quotes, 
for example, ‘123’. 


INVALID CDR FIELD NAME 
(list of defined search keys). INVALID CDR FIELD DATA STRING 
(list of defined search keys) 


Explanation: 
No search key is defined with the entered field name or value. 


User action: 
Choose a key to reset from the given list. 
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NO PARAMETERS SUPPLIED. 

ALL SEARCH KEYS WILL BE ERASED. 

DO YOU WANT ALL SEARCH KEYS ERASED? 

PLEASE CONFIRM (“YES”, “Y”, “NO”, “N”): 
Explanation: 


These messages appear in response to the valid RSETKEY options 
selected. 


User action: 
Respond to the Y/N prompt before continuing. 


NO SEARCH KEYS ARE CURRENTLY DEFINED 
Explanation: 
The RSETKEY command was issued, but there are no keys to reset. 


THIS COMMAND IS INHIBITED UNTIL A FILE HAS BEEN OPENED 
PLEASE USE THE SRCHFIL COMMAND TO OPEN A FILE 


Explanation: 


None of the commands available for FCDRSRCH on disk can be 
used until a billing file has been opened successfully. 


User action: 
Use the SRCHFIL command to open a billing file. 


Error messages 


The following error messages may display as a result of the RSETKEY 
command. 


INPUT INCOMPLETE, CDR FIELD STRING REQUIRED. INVALID INPUT, 
CDR FIELD STRING REQUIRED 


Explanation: 


A search key is defined by a field name and a valid value (string or 
number). 


User action: 
Enter the command again with both parameters. 


INVALID INPUT, RSETKEY ERROR 
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Explanation: 
A RSETKEY parameter entered could not be recognized. 


User action: 
Enter the command again with valid parameters. 


INVALID PARAMETER ENTERED RSETKEY ERROR !! 


Explanation: 
The parameter entered for CDR field name was unrecognizable. 


User action: 
Enter the command again. 


NO KEYS CURRENTLY DEFINED 


Explanation: 

If no keys are defined and the user enters the SETKEY command 
with no parameters, this message appears instead of the key 
definitions. 


RESET DENIED, NO CHANGES MADE 


Explanation: 
This verifies that the user chose not to reset the key(s) originally 
specified. 


RSETKEY ERROR !! SHARED DATA TABLE NOT ALLOCATED. SETVAL ID 
NOT FOUND 


Explanation: 


The command cannot be performed because the shared data segment 
has not been allocated or has been destroyed. 


User action: 

Issue a WARM RESTART. This reinitializes the shared data segment. 
If this does not clear the problem, more memory is needed to support 
the feature or a restart base is required to reset proper memory 
management. 


Related commands 
The following commands are related: 


e BACKUP 
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RSETKEY (end) 


e BLOCK 

e CDRTYPE 

e DISPLAY 

e EXECSRCH 
e FORWARD 

e HELP 

e LISTFLDS 

e NUMOUT 

e NUMSRCH 
e OPERATOR 
e QUIT 

e REINIT 

e SETKEY 

e SRCHFIL 

e SRCHSTAT 
e STATUS 

- WINDOW 
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SETKEY 
Purpose 
The Set Key (SETKEY) command allows you to define the search keys 
necessary to retrieve the desired CDRs from the selected billing file. When 
the command is executed, it looks through the CDR file and finds the CDR 
that matches the search key. 
Access 
>MAPCI;MTC;APPL;OAMAP;FCDRSRCH 
Syntax 
>SETKEY <CDR field><value> 
Parameters 
The command parameters are described in Table 1-98. 
Table 1-98 
SETKEY parameter descriptions 
Parameter Values Descriptiion 
CDR field Up to 8-character | CDR field name as shown by the result of the LISTFLDS 
field name command 
value 16 digits (0 to 9, Optional; pertinent to the desired CDR field 
A-F, N, Y) 


If the data is numeric and less than six characters, it must be 
enclosed by single quotes 


TRMOSEAS 0 to9 International Call Indicator 
OPERINV O0to9 Operator Involvement Indicator 
ROUTIND O0to5 IC/INC Routing Indicator 
COMPCODE2 0 to 999 Completion Indicator 
MODMAP 0 to 999 Module Code 

AMACALLT 0 to 999 Translation Settable Field 1 
SVCFTR 0 to 999 Translation Settable Field 2 
TERMPLAN N/A RESERVED for future use 
ORIGPLAN 

EXOSEAS 
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The CDR field and value parameters are an optional parameter group and 
must be supplied together to define a search key. 


The asterisk (*) character may be used in one of the following two ways: 


e If entered as the value for any search key, the asterisk causes all CDRs 
encountered to be considered matches and to be placed in the output 
buffer. 


e If entered as the last character of a search key value, the asterisk causes 
only those characters preceding it to be considered in the search 
comparison for that key. 


If an improper CDR field is entered, a message displays indicating an 
invalid request. 


Note: A maximum of 51 fields can be defined for your search. 


When SETKEY is invoked without parameters, a list of the current key 
definitions displays. If none are defined, a message displays indicating that 
no search keys have been defined. 


This command has no effect upon the FCDRSRCH menu status area. 


Example commands 


Responses 


>SETKEY EXOPCH ‘171’ 


The following are possible responses to the SETKEY command. 


CDR INDEX NOT FOUND. .SETVAL. 

CLLI NOT FOUND IN DATA DICTIONARY. KEY DOES NOT MATCH BCD 
FORMAT. INVALID CDR FIELD INPUT. 

FIELD NOT FOUND IN THE CDR. 

THE VALID FIELDS ARE: (list of valid fields) 


Explanation: 
An attempt was made to set up a search key that does not match a 
field in the CDR record format. 


User action: 
Reissue the SETKEY command using a legal field name. 


INPUT INCOMPLETE, CDR FIELD STRING REQUIRED. 
INVALID INPUT, CDR FIELD STRING REQUIRED 
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INPUT 


Explanation: 
A search key is defined by a field name and a valid value (string or 
number). 


User action: 
Enter the command again with both parameters. 


INCORRECT 


Explanation: 
The data item supplied using the SETKEY command is not a string. 


User action: 
Reissue the command and enclose the data item within single quotes, 
for example, ‘12345678901’. 


INVALID PARAMETER ENTERED. 
SETKEY ERROR !! 


Explanation: 
The parameter entered for CDR field name was unrecognizable. 


User action: 
Enter the command again. 


NO KEYS CURRENTLY DEFINED 


Explanation: 

If no keys are defined and the user enters the SETKEY command 
with no parameters, this message appears instead of the key 
definitions. 


NO PARAMETER SUPPLIED. 
ALL CURRENT KEY DEFINITIONS WILL BE LISTED 


Explanation: 
This message displays when the SETKEY command is entered 
without parameters. 


NUMBER OF SEARCH KEYS LIMIT EXCEEDED. 


COULD 


NOT UPDATE THE SVALUES TABLE 


Explanation: 
An attempt was made to specify more search values than can fit in 
the shared data segment. 
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User action: 
Use the RESETVAL command to reinitialize the search keys and 
enter only the search values required for the search. 


SETKEY ERROR !! 
SHARED DATA TABLE NOT ALLOCATED. SETVAL ID NOT FOUND 


Explanation: 
The command cannot be performed because the shared data segment 
has not been allocated or has been destroyed. 


User action: 

Issue a WARM RESTART. This reinitializes the shared data segment. 
If this does not clear the problem, more memory is needed to support 
the feature or a restart base is required to reset proper memory 
management. 


THIS COMMAND IS INHIBITED UNTIL A FILE HAS BEEN OPENED PLEASE 
USE THE SRCHFIL COMMAND TO OPEN A FILE 


Explanation: 
None of the commands available for CDR search on disk can be used 
until a billing file has been opened successfully. 


User action: 
Use the SRCHFIL command to open a billing file. 


Related commands 
The following commands are related: 


BACKUP 
BLOCK 
CDRTYPE 
DISPLAY 
EXECSRCH 
FORWARD 
HELP 
LISTFLDS 
NUMOUT 
NUMSRCH 
OPERATOR 
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QUIT 
REINIT 
RSETKEY 
SRCHFIL 
SRCHSTAT 
STATUS 
WINDOW 
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Purpose 


The SRCHFIL command is used to open a billing file in the DIRP or DRM 
recording systems. 


Note: DIRP resides on the DMS-Core and DRM resides on the Billing 
Server file processor (FP). 


The files can be opened at specified blocks or at the start of the file. These 
files are available for read access only. All data on the file is decoded by the 
inherent or specified formatters. Formats can be UCSO5, UCS06, 
UCSO6FLEX, or any other CDR datafilled in table CDRTMPLT. 


Refer to the UCS DMS-250 Billing Server Application Guide for more 
information. 

The SRCHFIL command sets the following for search purposes: 

e billing file name 


e call record format name (from table CRSFMT for DIRP or table 
SBSFMT for DRM) 


e current block number fields of the FCDRSRCH menu status area 


Each time this command is invoked successfully, the following occurs: 
e Any defined search parameters are set to their default values. 
¢ The output buffer is erased. 


e The output buffer record position field of the FCDRSRCH menu status 
area is blanked out. 


ATTENTION 
All FCDRSRCH commands except QUIT are inhibited until a billing 
file is opened. The SRCHFIL command must always be the first 
command entered for the initial search session. 


Access 
>MAPCI;MTC;APPL;OAMAP;FCDRSRCH 


Syntax 


There are two modes: automatic and manual. 
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Automatic mode 

>SRCHFIL stream dirpstate [beginning _block_number] 
Manual mode 

>SRCHFIL filename cdrformat [beginning_block_number] 


Parameters 
Automatic mode 
The automatic mode parameters are described in Table 1-99. 


Table 1-99 
SRCHFIL automatic mode parameter descriptions 
Parameter Values Description 
stream OCC, OCC A Billing stream as datafilled in table DIRPSSYS field 
SSYSNAME. 
dirpstate ACTIVE, PARALLEL Specific file to search. 
beginning_ 1 |2 ... 9999998 | Optional; Positive integer; numbers larger than 32767 
block _ 9999999 must be enclosed in quotes. 
number 


Manual mode 
The manual mode parameters are described in Table 1-100. 
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Table 1-100 
SRCHFIL manual mode parameter descriptions 
Parameter Values Description 
filename DRM filename in the where: 
format: INODE/DEVICEVOLUME = the current full path of 
::NODE/DEVICEVOLUME/ the filename 
XNYYMMDDHHmmSQ X = file states (A, U, P, or R) 
APPL A- Available 
U- Unprocessed 
P- Processed 
R- Removed 
N =“N” 
YY = Year 
MM = Month 
DD = Day 
HH = Hour 
mm = Minute 
SQ = Sequence number. This field has a value 
from 0 to 99. 
APPL = Application name as datafilled in table 
DRMAPPL, field APPLNAME. This field can be up 
to four characters long, for example, AMA, OCC, 
OM, or JF. 
filename DIRP filename in the where: 
format: X = file states (A, U, P, or R) 
XYYMMDDHHmmSQ A- Available 
SSYS U- Unprocessed 


P- Processed 
R- Removed 
YY = Year 
MM = Month 
DD = Day 
HH = Hour 
mm = Minute 
SQ = Sequence number. This field has a value 
from 0 to 99. 
SSYS = Subsystem name as datafilled in table 
DIRPSSYS, field SSYSNAME. 


297-2621-819 Standard 14.01 April 2002 


Commands 1-471 


FCDRSRCH commands 
SRCHEFIL (continued) 


Table 1-100 
SRCHFIL manual mode parameter descriptions (continued) 
Parameter Values Description 
format UCS, UCSEOPS STREAM format as datafilled in table CRSFMT, 
field CDRSRCH. 
block# 1 | 2... 9999998 | Optional; Positive integer; numbers smaller than 
9999999* 32767 must be enclosed in quotes. 


Example command 
The following is an example for DRM: 
>SRCHFIL ::fp0/fp0ssOocc/UN9604051038000CC ucs 


The following is an example for DIRP: 


>SRCHFIL A9810090545020CC ACT 


Responses 
The following are possible responses to the SRCHFIL command. 
ACTIVE AND PARALLEL CDR TAPES CANNOT BE SEARCHED 


Explanation: 

Billing tapes cannot be searched by the automatic mode. This may 
also occur on a DIRP device if the disk volume where the file resides 
has not been listed. 


User action: 
Locate the disk volume and list it. 


DEVICE NOT SUPPORTED FOR CDR SEARCHING 


Explanation: 
Only FTFS disks are supported for CDR searching. 


EITHER INCORRECT OPTIONAL PARAMETER(S) OR TOO MANY PARAMETERS 


Explanation: 
If this happens during the SRCHFIL command, it is likely that a 
block number was entered out of range. 
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User action: 
Enter the command again with a correct value. 


FILENAME NOT FOUND, PLEASE LIST THE CDR VOLUME 


Explanation: 
The filename supplied cannot be accessed for the manual mode. 


User action: 
Ensure that the device directory is properly attached and the correct 
spelling of the filename is given. 


FORMAT INVALID; READ BUFFER NOT ALLOCATED 


Explanation: 
The billing format given by the user was not valid. 


User action: 
Enter the SRCHFIL command again with a valid format. 


FORMAT SYMBOL NOT FOUND IN THE DATA DICTIONARY. 
VALID CDR SEARCH FORMATS ARE: (list of valid format names) 


Explanation: 
The FORMAT entered is not one of the formats in the data 
dictionary. 


User action: 
Check the list of valid formats and choose the correct format. 


MISSING FIELD IN CDR FORMAT TYPEDESC. 
MISSING FIELD IN THE CDR LOG FORMAT TYPEDESC 


Explanation: 
The supplied format for the SRCHFIL command cannot be used for 
CDR search on disk. 


User action: 
Contact the technical assistance center if this message persists. 


NO FILE IS OPEN FOR STREAM XXX 


Explanation: 
The billing files for this stream are not open. 


User action: 
Activate the stream. 
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STORAGE NOT ALLOCATED FOR THE OUTPUT BUFFER. 
SEARCH VALUES BUFFER NOT ALLOCATED READ BUFFER NOT ALLOCATED 


Explanation: 
Storage was not available to be allocated or could not be allocated 
for use by FCDRSRCH. 


STREAM NAME NOT FOUND IN THE DATA DICTIONARY 


VALID 


TABLE 


STREAM NAMES ARE: (list of stream names) 


Explanation: 
The STREAM name entered is not known to the data dictionary. 


User action: 
Check the list of valid streams and choose the desired name. 


CRSFMT HAS NOT BEEN DATAFILLED 


Explanation: 
Table CRSFMT has not been datafilled. 


User action: 
Datafill table CRSFMT. 


THE FCDRSRCH FIELD OF THE XXX STREAM TUPLE IN TABLE CRSFMT 
MUST BE ONE OF THE FOLLOWING: (list of valid formats) 


Explanation: 
The FCDRSRCH field of table CRSFMT has been incorrectly filled 
for the specified stream. 


User action: 
Change the FCDRSRCH field in table CRSFMT to a valid value. 


Error messages 


The following error messages may display as a result of the SRCHFIL 
command. 


ERROR: 


<filename> not available 


Explanation: 
The filename supplied cannot be accessed for the manual mode. 


User action: 
Ensure that the device is online and that the correct spelling of the 
filename and path given. 
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ERROR: Failed to get active filename from DRM. 


Explanation: 
DRM could not find the stream name supplied. 


User action: 
Check the billing stream and FP status, and check the spelling of the 
stream name. 


Related commands 
The following commands are related: 


e BACKUP 

e BLOCK 

e CDRTYPE 

e DISPLAY 

e EXECSRCH 
e FORWARD 

e HELP 

e LISTFLDS 

e NUMOUT 

e NUMSRCH 
e OPERATOR 
e QUIT 

© REINIT 

e RSETKEY 

e SETKEY 

e STATUS 

e  SRCHSTAT 
e WINDOW 
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Purpose 


Access 
Syntax 


Parameters 


The search status (SRCHSTAT) command allows the FCDRSRCH status 
area information to be displayed on the MAP terminal screen. 


the SRCHSTAT command is a hidden command and does not show in the 
command menu at the OAMAP level of MAPCI. 


SRCHSTAT requires no parameters and only outputs data to the MAP 
terminal. 


>MAPCI NODISP;MTC;APPL;OAMAP;FCDRSRCH 


>SRCHSTAT 


None 


Example command 


Responses 


>SRCHSTAT 


This command is inhibited until a file has been opened. Use the SRCHFIL 
command to open a file, as shown in the following example and response. 


>SRCHFIL OCC ACT 
>SRCHSTAT 


The following is a possible response to the SRCHSTAT command. 


THIS COMMAND IS INHIBITED UNTIL A FILE HAS BEEN OPENED. 
PLEASE USE THE SRCHFIL COMMAND TO OPEN A FILE 


Explanation: 
None of the commands available for FCDRSRCH can be used until a 
billing file has been opened successfully. 


User action: 
Use the SRCHFIL command to open a billing file. 
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Related commands 
The following commands are related: 


e BACKUP 

e BLOCK 

e CDRTYPE 

e DISPLAY 

e EXECSRCH 
e FORWARD 

e HELP 

e LISTFLDS 

e NUMOUT 

e NUMSRCH 
e OPERATOR 
e QUIT 

«© REINIT 

e RSETKEY 

e SETKEY 

e SRCHFIL 

e STATUS 

e WINDOW 


297-2621-819 Standard 14.01 April 2002 


Commands 1-477 


FCDRSRCH commands 
STATUS 


Purpose 


Access 
Syntax 


Parameters 


The STATUS command provides the following criteria about the last 
completed search: 


e the number of records searched 
e the number of records output 


e atime reference for the last record checked (if a nondefault time window 
was specified) 


>MAPCI;MTC;APPL;OAMAP;FCDRSRCH 


>STATUS 


None 


Example command 


Responses 


>STATUS 


The following are possible responses to the STATUS command. 


LAST DISCONNECT TIME CHECKED (NON-DEFAULT WINDOW ONLY): (time 
ref., if applicable) 


Explanation: 
Messages displayed each time STATUS command is invoked 


NUMBER OF RECORDS SEARCHED = (searched) 


Explanation: 
Messages displayed each time STATUS command is invoked 


NUMBER OF RECORDS OUTPUT = (# output) 


Explanation: 
Messages displayed each time STATUS command is invoked 


THIS COMMAND IS INHIBITED UNTIL A FILE HAS BEEN OPENED. 
PLEASE USE THE SRCHFIL COMMAND TO OPEN A FILE 
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Explanation: 
None of the commands available for FCDRSRCH on disk can be 
used until a billing file has been opened successfully. 


User action: 
Use the SRCHFIL command to open a billing file. 


Error messages 


The following error messages may display as a result of the STATUS 
command. 


STATUS ERROR 


Explanation: 


The command cannot be performed because the shared data segment 


has not been allocated or has been destroyed. 


User action: 
Schedule a WARM RESTART. This reinitializes the shared data 


segment. If it does not clear the problem, more memory is needed to 


support the feature, or a restart base is required to reset proper 
memory management. 


Related commands 
The following commands are related: 


BACKUP 
BLOCK 
CDRTYPE 
DISPLAY 
EXECSRCH 
FORWARD 
HELP 
LISTFLDS 
NUMOUT 
NUMSRCH 
OPERATOR 
QUIT 
REINIT 


297-2621-819 Standard 14.01 April 2002 


Commands 1-479 


FCDRSRCH commands 
STATUS (end) 


RSETKEY 
SETKEY 
SRCHFIL 
SRCHSTAT 
WINDOW 
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WINDOW 


Purpose 


Access 


Syntax 


The WINDOW command allows you to define a time window within the 
active collection period of the selected billing file in which the search for 
call detail records (CDR) that match the defined search keys is to be 
conducted. 


With the exception of the year fields, WINDOW parameters may contain 
only one digit, if appropriate. (for example, 5 instead of 05 for the month of 
May.) WINDOW parameters must be separated by spaces when entered. 


The WINDOW command accepts two optional parameter groups: the 
beginning of the time window and the end of the time window. 


When the WINDOW command is invoked without parameters, the time 
window for the next search session is set to the entire billing file. If no 
window has been defined, a message displays indicating that the default time 
window is already active. 


When the first optional parameter group is given without the second, the 
search begins within the billing file at the specified time and the search 
session ends by a stopping condition other than the time window. If both 
parameter groups are supplied, the search session begins and ends at the 
specified time points within the selected billing file. 


The ending time cannot be supplied without a beginning time. If such an 
attempt is made, the supplied time is interpreted as the beginning of the time 
window. 


When the WINDOW command is successfully invoked, the beginning of the 
time window and the end of the time window FCDRSRCH menu status 
fields are set to the supplied data. When the default case is active, these two 
fields are blank. This situation indicates that the entire billing file is 
considered the time window for the search session. When the ending time is 
not supplied, its corresponding status field remains blank to indicate that the 
end of data on the billing file is also the end of the time window. 


>MAPCI;MTC;APPL;OAMAP;FCDRSRCH 


>WINDOW YYYY MM DD HH MM YYYY MM DD HH MM 
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Parameters 


The command parameters are described in Table 1-101. 


Table 1-101 

WINDOW parameter descriptions 
Parameter Values Description 
start year numeric beginning year for the time window YYYY 
start month numeric beginning month for the time window MM 
start day numeric beginning day for the time window DD 
start hour numeric beginning hour for the time window HH 
start minute numeric beginning minute for the time window MM 
end year numeric ending year for the time window YYYY 
end month numeric ending month for the time window MM 
end day numeric ending day for the time window DD 
end hour numeric ending hour for the time window HH 
end minute numeric ending minute for the time window MM 


Example command 
>WINDOW 1996 12 24 17 00 1997 01 01 00 00 


Responses 


The following are possible responses to the WINDOW command. 


ENTER THE START TIME AND DATE : YYYY MM DD HH MM 


Explanation: 


The first half of the time window has not been specified. 


User action: 


Enter the first half of the time window. 


ENTER THE STOP TIME AND DATE: 


YYYY MM DD HH MM 


Explanation: 


The second half of the time window has not been specified. 
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User action: 
Enter the second half of the time window. 


THIS COMMAND IS INHIBITED UNTIL A FILE HAS BEEN OPENED PLEASE 
USE THE SRCHFIL COMMAND TO OPEN A FILE. 


Explanation: 
None of the commands available for FCDRSRCH on disk can be 
used until a billing file has been opened successfully. 


User action: 
Use the SRCHFIL command to open a billing file. 


NO CHANGES MADE TO WINDOW. ENTER “Q WINDOW” TO VERIFY 
PARAMETER RANGES. 


Explanation: 

Response was NO to the prompt indicating that no parameters or 
invalid parameters have been entered. No changes have been made to 
the time window. 


NO BEGIN TIME OR INVALID BEGIN TIME SUPPLIED. DO YOU WANT THE 
DEFAULT WINDOW SETTING (NO TIME WINDOW) ? 


Explanation: 

Invalid parameters or no parameters have been entered. A prompt is 
given at this point to allow the user to examine the entered 
parameters and abort the command, if desired. 


NO END TIME OR INVALID END TIME SUPPLIED. DO YOU WANT THE 
DEFAULT WINDOW END (END OF THE FILE) 


Explanation: 

Invalid parameters or no parameters have been entered. A prompt is 
given at this point to allow the user to examine the entered 
parameters and abort the command, if desired. 


SEARCH TIME WINDOW NOT SET 


Explanation: 
A time window has not yet been specified for the search. 


User action: 
Use the WINDOW command if a window is desired, otherwise, 
ignore. 
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START TIME JULIAN CONVERSION FAILED 
STOP TIME JULIAN CONVERSION FAILED 


Explanation: 
The data supplied for the WINDOW command cannot be converted 
to Julian time. 


User action: 
Contact the technical assistance center if either of these messages 
persists. 


TIME WINDOW MAY BE SPECIFIED FOR DISK FILES ONLY. 


Explanation: 
A FCDRSRCH application that is not supported was attempted. 


TIME WINDOW MAY NOT BE SPECIFIED FOR PARALLEL BILLING FILES 


Explanation: 
A FCDRSRCH application that is not supported was attempted. 


TIME WINDOW SET TO DEFAULT 


Explanation: 
Default window option was chosen 


WINDOW END SET END OF FILE. 
Explanation: 
Default window option was chosen 


Error messages 


The following error messages may display as a result of the WINDOW 
command. 


INVALID PARAMETER WINDOW ERROR 


Explanation: 
Parameter not recognized 


User action: 
Enter the command again. 


BEGIN TIME > END TIME. WINDOW REQUEST DENIED. 


Explanation: 
The start and stop times were entered out of sequence. 
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FCDRSRCH commands 
WINDOW (continued) 


User action: 
Enter the command again. 


WINDOW ERROR !! 


Explanation: 
The command cannot be performed because the shared data segment 
has not been allocated or has been destroyed. 


User action: 

Issue a WARM RESTART to reinitialize the shared data segment. If 
it does not clear the problem, more memory is needed to support the 
feature or a restart base is required to reset proper memory 
management. 


Related commands 
The following commands are related: 


e BACKUP 

e BLOCK 

e CDRTYPE 

e DISPLAY 

e EXECSRCH 
e FORWARD 

e HELP 

e LISTFLDS 

e NUMOUT 

e NUMSRCH 
e OPERATOR 
e QUIT 

e REINIT 

e RSETKEY 

e SETKEY 

e SRCHFIL 
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FCDRSRCH commands 
WINDOW (end) 


e SRCHSTAT 
e STATUS 
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FindlT Tool 


Purpose 


Access 


Syntax 


The FINDIT command assists the user by returning the location(s) on the 
switch of a designated file. 


Cl: FINDIT 


FINDIT < FILE-NAMBE> [all] 


FINDIT Parameter Description 


Parameter 
File Name 
All 


Values Description 


Identifies the file to be located. 


Optional parameter used to sig- 
nify if all locations of the desig- 
nated file are to be returned to 
the user. 


Example commands 


FINDIT patch_xyz 


File patch_xyz is located on device SFDEV. 
File patch_xyz is located on device SOODMISC 


Note: The FINDIT tool has implicit wild cards at the beginning and the end 
of the file entered. The tool returns the file and the device which include the 
string of characters entered by the user. If the option “all” is not specified, 
only the location of the first occurrence of the file is identified. 
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2-2 Commands 


FLEXCONV 
FLEXCONV directory (end) 


Purpose 
The FlexDial Conversion (FLEXCONV) command accesses the 
FLEXCONYV directory. 

Access 
All FLEXCONV commands are accessed through the following command: 


>MAPCI;MTC;TRKS;TTP;LEVEL FLEXCONV 


Related commands 
The following commands are accessed through the FLEXCONV directory: 
e CHNGROUT 
e DELREN 
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FLEXCONV commands 
CHNGROUT 
Purpose 
The Change Route (CHNGROUT) command searches route reference tables 
for the specified CLLI and changes the current name to a new CLLI name. 
Access 
>MAPCI;MTC;TRKS;TTP;LEVEL FLEXCONV 
Syntax 
>CHNGROUT OLDGRP STRING OLD trunk group name 
>NEWGRP STRING NEW trunk group name 
Parameters 
Command parameters are described in Table 1-1. 
Table 1-1 


CHNGROUT parameter descriptions 


Parameter Values Description 

OLDGRP CLLI Specifies the “old” trunk group name. 

NEWGRP CLLI Specifies the “new” trunk group name. 
—end— 


Example command 
>CHNGROUT OLDGRP1 NEWGRP1 


Responses 
The following are possible responses to the CHNGROUT command: 


Change route completed. 


Explanation: 
All the route references to the old trunk group have been changed. 
The route references are now pointing to the new trunk group. 


User action: 
None. The switch displays the message on the terminal when the 
command is completed. 
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2-4 Commands 


FLEXCONV commands 
CHNGROUT (continued) 


Error messages 


The following error messages may display as a result of the CHNGROUT 
command: 


Error: 
in an 


Error: 


At least one trunk of the group <new clli> should be 
idle state 


Explanation: 

The user tried to change the route reference to a group which has no 
trunk in idle state. This can disrupt the traffic on the specified trunk 
group, because there are no trunks available for call process. 


User action: 

Check the reason for there being no members in an idle state in the 
specified group. If the specified group has no members at all, then 
execute the MVMEMBER command. 


CLLI <clli> is not valid 


Explanation: 
The old (or new) trunk group name entered by the user as a 
parameter is not recognized by the system. 


User action: 
Verify the CLLI names. If valid names have been specified, verify 
the trunk group definitions. 


Failure: Command is aborted. 
See FLCV logs for additional information 


Explanation: 

The change route references operation has been stopped. See logs for 
a reason of the failure. This message is displayed when a change in a 
table has failed. 


System action: 
Stops the change route reference process. 


User action: 
Use logs to verify reason for failure. Then run CHNGROUT again. 
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FLEXCONV commands 
CHNGROUT (end) 


Related commands 
The following command is accessed through the FLEXCONV directory: 


e DELREN 
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2-6 Commands 


FLEXCONV commands 


DELREN 


Purpose 


Access 


Syntax 


Parameters 


Table 1-2 


The Delete and Rename (DELREN) command deletes the old CLLI trunk 
group name and renames the new CLLI trunk group. 


Note: Because all members of the old trunk group have been moved to the 
new group, the old trunk group can be deleted; the new trunk group can be 
renamed to match the old trunk group name. 


WARNING 

This command deletes the old trunk group. 

This command should only be executed after all the 
members of the old trunk group have been moved to the 
new trunk group. 


>MAPCI;MTC;TRKS;TTP;LEVEL FLEXCONV 


>DELREN OLDGRP STRING OLD trunk group name 
NEWGRP STRING NEW trunk group name 


Command parameters are described in Table 1-2. 


DELREN parameter descriptions 


Parameter Values Description 

OLDGRP CLLI Specifies the “old” trunk group name. 

NEWGRP CLLI Specifies the “new” trunk group name. 
—end— 


Example command 


>DELREN OLDGRP1 NEWGRP1 


Done 
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FLEXCONV commands 
DELREN (continued) 


Responses 


The following may display in response to the DELREN command: 


Done. 


Explanation: 
The switch completed the delete and rename command successfully. 
The switch has deleted the old trunk group. 


System action: 
The switch displays the message on the terminal when the command 
is completed. 


Error messages 


The following error messages may display as a result of the DELREN 
command: 


Error: 


Error: 


Error: 
group 


The <old clli> group has members 


Explanation: 
User has attempted to delete a trunk group that still has members. 


User action: 

Move the remaining members in the old trunk group to the new trunk 
group. For example, execute the MOVE command with the 
percentage parameter 100. 


CLLI <clli> is not valid 


Explanation: 
The switch does not recognize the old trunk group name or the new 
trunk group name. 


User action: 
Verify the CLLI names. If valid names have been specified, verify 
the trunk group definitions. 


The old trunk group CLLI is the same as the new trunk 
CLLi entered 


Explanation: 
Command has specified a new CLLI trunk group name that is the 
same as the old CLLI trunk group name 
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2-8 Commands 


FLEXCONV commands 
DELREN (end) 


User action: 
Re-execute the command with the proper parameters. 


Related commands 
The following command is related: 
e CHNGROUT 
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LOGUTIL directory 


LOGUTIL 
Purpose 
The Log Utility (LOGUTIL) command allows the user to accesses the 
LOGUTIL directory. 
Access 
>LOGUTIL 


Related commands 
The following commands are accessible in the LOGUTIL directory: 


e ADDCLASS 
e ADDREP 

e BACK 

e BACKUP 

e CLASS 

e CLEAR 

e CONTEXT 

e DELCLASS 
e DELDEVICE 
e DELREP 

e DUMPLOGS 
e FIRST 

e FORMAT 

e FORWARD 

e LAST 

e LSITDEVS 

e LISTLOGS 

e LISTNODES 
e LISTREPS 

e LISTROUTE 
e LISTTIME 

e MODE 

e OPEN 
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2-10 Commands 


LOGUTIL directory 
LOGUTIL (end) 


e RENUMBER 

e REROUTE 

e RESET 

e RESETROUTE 
e RESUME 

e RESUMEDEV 
e START 

e STARTDEV 

e STOP 

e STOPDEV 

e SUPPRESS 

e THRESHOLD 
e TIMEREST 

e TYPE 
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LOGUTIL commands 


ADDCLASS 
Purpose 
Use the ADDCLASS command to add classes to those classes printed by a 
certain device. 
Access 
>LOGUTIL 
Syntax 
>ADDCLASS io_device classnum 
Parameters 
The command parameters are described in Table 1-3. 
Table 1-3 
ADDCLASS parameter descriptions 
Parameter Values Description 
io_device The input/output (I/O) device 
classnum The class number or numbers to add 
—end— 


Example command 
>ADDCLASS prt 2 


Related commands 
The following commands are related: 
e ADDREP 
e BACK 
e BACKUP 
e CLASS 
e CLEAR 
e CONTEXT 
e DELCLASS 
e DELDEVICE 
e DELREP 
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LOGUTIL commands 
ADDCLASS (end) 


e DUMPLOGS 
e FIRST 

e FORMAT 

e FORWARD 

e LAST 

e LSITDEVS 

e LISTLOGS 

e LISTNODES 

e LISTREPS 

e LISTROUTE 
e LISTTIME 

e MODE 

e OPEN 

e RENUMBER 
e REROUTE 

e RESET 

e RESETROUTE 
e RESUME 

e RESUMEDEV 
e START 

e STARTDEV 

e STOP 

e STOPDEV 

e SUPPRESS 

e THRESHOLD 
e TIMEREST 

e TYPE 
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LOGUTIL commands 


ADDREP 
Purpose 
Use the ADDREP command to add reports to those reports handled by a 
certain device. 
Access 
>LOGUTIL 
Syntax 
>ADDREP io _ device logname repnum 
Parameters 
The command parameters are described in Table 1-4. 
Table 1-4 


ADDREP parameter descriptions 


Parameter Values Description 

io_device The input/output (I/O) device 

logname The class number or numbers to add 

repnum The report number or numbers 
—end— 


Example command 
>ADDREP prt topp 100 


Responses 
None 


Related commands 
The following commands are related: 


e ADDCLASS 
e ADDREP 

e BACK 

e BACKUP 

e CLASS 

e CLEAR 


Digital Switching Systems UCS DMS-250 Commands Reference Manual UCS17 


2-14 Commands 


LOGUTIL commands 
ADDREP (continued) 


e CONTEXT 

e DELCLASS 

e DELDEVICE 
e DELREP 

e DUMPLOGS 
e FIRST 

e FORMAT 

e FORWARD 

e LAST 

e LSITDEVS 

e LISTLOGS 

e LISTNODES 

e LISTREPS 

e LISTROUTE 
e LISTTIME 

e MODE 

e OPEN 

e RENUMBER 
e REROUTE 

e RESET 

e RESETROUTE 
e RESUME 

e RESUMEDEV 
e START 

e STARTDEV 

e STOP 

e STOPDEV 

e SUPPRESS 

e THRESHOLD 
e TIMEREST 
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LOGUTIL commands 
ADDREP (end) 


TYPE 
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LOGUTIL commands 


BACK 


Purpose 


Use the BACK command to display the log report entry before this current 
log report in the log buffer. 


Access 


>LOGUTIL 


Syntax 


>BACK number | all 


Parameters 


The command parameters are described in Table 1-5. 


Table 1-5 


BACK parameter descriptions 


Parameter 


Values 


Description 


number 


all 


Numeric; 1 to 32767; 


the default is 1. 


The number of entries from the current report that 
you wish to display 


Specifies the display of all the prior reports 


—end— 


Example command 
>BACK 2 


Responses 


None 


Related commands 
The following commands are related: 


ADDCLASS 
ADDREP 
BACKUP 
CLASS 
CLEAR 
CONTEXT 
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LOGUTIL commands 
BACK (continued) 


DELCLASS 
DELDEVICE 
DELREP 
DUMPLOGS 
FIRST 
FORMAT 
FORWARD 
LAST 
LSITDEVS 
LISTLOGS 
LISTNODES 
LISTREPS 
LISTROUTE 
LISTTIME 
MODE 

OPEN 
RENUMBER 
REROUTE 
RESET 
RESETROUTE 
RESUME 
RESUMEDEV 
START 
STARTDEV 
STOP 
STOPDEV 
SUPPRESS 
THRESHOLD 
TIMEREST 


Digital Switching Systems UCS DMS-250 Commands Reference Manual UCS17 


2-18 Commands 


LOGUTIL commands 
BACK (end) 


e TYPE 
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LOGUTIL commands 


BACKUP 
Purpose 
Use the BACKUP command to make an archive copy of reports. 
Access 
>LOGUTIL 
Syntax 
>BACKUP io_device 1 by io_device 2 
Parameters 
The command parameters are described in Table 1-6. 
Table 1-6 
BACKUP parameter descriptions 
Parameter Values Description 
io_device The input device for the backup copy 
by Required to clarify the command syntax 
io_device The output device for the backup copy 
—end— 


Example command 
>BACKUP d000scratch by d010scratch 


Responses 
None 


Related commands 
The following commands are accessible in the LOGUTIL directory: 


e ADDCLASS 
e ADDREP 

e BACK 

e CLASS 

e CLEAR 

e CONTEXT 
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LOGUTIL commands 
BACKUP (continued) 


e DELCLASS 

e DELDEVICE 
e DELREP 

e DUMPLOGS 
e FIRST 

e FORMAT 

e FORWARD 

e LAST 

e LSITDEVS 

e LISTLOGS 

e LISTNODES 

e LISTREPS 

e LISTROUTE 
e LISTTIME 

e MODE 

e OPEN 

e RENUMBER 
e REROUTE 

e RESET 

e RESETROUTE 
e RESUME 

e RESUMEDEV 
e START 

e STARTDEV 

e STOP 

e STOPDEV 

e SUPPRESS 

e THRESHOLD 
e TIMEREST 
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LOGUTIL commands 
BACKUP (end) 


TYPE 
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LOGUTIL commands 
CLASS 
Purpose 
Use the CLASS command to set the class of selected reports. 
Access 
>LOGUTIL 
Syntax 
>CLASS classnum logname repnum 
Parameters 
The command parameters are described in Table 1-7. 
Table 1-7 


CLASS parameter descriptions 


Parameter Values Explanation 

classnum Numeric; 0 to 31 The class number 

logname The log name or names 
repnum The report number or numbers 


—end— 


Example command 


> 


Responses 


None 


Related commands 
The following commands are accessible in the LOGUTIL directory: 


ADDCLASS 
ADDREP 
BACK 
BACKUP 
CLEAR 
CONTEXT 
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LOGUTIL commands 
CLASS (continued) 


DELCLASS 
DELDEVICE 
DELREP 
DUMPLOGS 
FIRST 
FORMAT 
FORWARD 
LAST 
LSITDEVS 
LISTLOGS 
LISTNODES 
LISTREPS 
LISTROUTE 
LISTTIME 
MODE 

OPEN 
RENUMBER 
REROUTE 
RESET 
RESETROUTE 
RESUME 
RESUMEDEV 
START 
STARTDEV 
STOP 
STOPDEV 
SUPPRESS 
THRESHOLD 
TIMEREST 
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LOGUTIL commands 
CLASS (end) 


e TYPE 
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LOGUTIL commands 


CLEAR 
Purpose 
Use the CLEAR command to delete all reports from a log. 
Access 
>LOGUTIL 
Syntax 
>CLEAR logname 
Parameters 
The parameter fields are described in Table 1-8. 
Table 1-8 
CLEAR parameter description 
Parameter Values Description 
logname The name of the log to clear 
—end— 


Example command 
>CLEAR aud 


Responses 
None 


Related commands 
The following commands are accessible in the LOGUTIL directory: 


e ADDCLASS 
e ADDREP 

e BACK 

e BACKUP 

e CLASS 

e CONTEXT 

e DELCLASS 

e DELDEVICE 
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LOGUTIL commands 
CLEAR (end) 


e DELREP 

e DUMPLOGS 
e FIRST 

e FORMAT 

e FORWARD 

e LAST 

e LSITDEVS 

e LISTLOGS 

e LISTNODES 

e LISTREPS 

e LISTROUTE 
e LISTTIME 

e MODE 

e OPEN 

e RENUMBER 
e REROUTE 

e RESET 

e RESETROUTE 
e RESUME 

e RESUMEDEV 
e START 

e STARTDEV 

e STOP 

e STOPDEV 

e SUPPRESS 

e THRESHOLD 
e TIMEREST 

e TYPE 
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LOGUTIL commands 


CONTEXT 
Purpose 
Use the CONTEXT command to change the context of applicable nodes for 
the browsing command during the current session. 
Access 
>LOGUTIL 
Syntax 
>CONTEXT nodename nodenumber unitnumber 
Parameters 
The command parameters are described in Table 1-9. 
Table 1-9 
CONTEXT parameter descriptions 
Parameter Values Description 
nodename The name of a type of node that generates logs in 
the switch. For ENET, this variable is the plane 
number. 
nodenumber A specific node within a given type. For ENET, this 
variable is the shelf number. 
unitnumber The unit number for those nodes where the number 
is needed. 
—end— 


Example command 
>CONTEXT enet 0 0 


Responses 


None 


Related commands 
The following commands are accessible in the LOGUTIL directory: 


e ADDCLASS 
e ADDREP 
e BACK 
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LOGUTIL commands 
CONTEXT (continued) 


e BACKUP 

e CLASS 

e CLEAR 

e DELCLASS 

e DELDEVICE 
e DELREP 

e DUMPLOGS 
e FIRST 

e FORMAT 

e FORWARD 

e LAST 

e LSITDEVS 

e LISTLOGS 

e LISTNODES 
e LISTREPS 

e LISTROUTE 
e LISTTIME 

e MODE 

e OPEN 

e RENUMBER 
e REROUTE 

e RESET 

e RESETROUTE 
e RESUME 

e RESUMEDEV 
e START 

e STARTDEV 

e STOP 

e STOPDEV 

e SUPPRESS 
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LOGUTIL commands 
CONTEXT (end) 


e THRESHOLD 
e TIMEREST 
e TYPE 
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LOGUTIL commands 
DELCLASS 
Purpose 
Use the DELCLASS command to delete the classes from those printed by a 
device. 
Access 
>LOGUTIL 
Syntax 
>DELCLASS io_device classnum 
Parameters 
The parameters are described in Table 1-10. 
Table 1-10 
DELCLASS parameter descriptions 
Parameter Values Description 
io_device The input/output (I/O) device 
classnum Numeric; 0 to 31 The class number 
—end— 


Example command 
>DELDEVICE prt1 


Responses 
None 


Related commands 
The following commands are accessible in the LOGUTIL directory: 


e ADDCLASS 
e ADDREP 

e BACK 

e BACKUP 

e CLASS 

e CLEAR 

e CONTEXT 


297-2621-819 Standard 14.01 April 2002 


Commands 2-31 


LOGUTIL commands 
DELCLASS (end) 


DELDEVICE 
DELREP 
DUMPLOGS 
FIRST 
FORMAT 
FORWARD 
LAST 
LSITDEVS 
LISTLOGS 
LISTNODES 
LISTREPS 
LISTROUTE 
LISTTIME 
MODE 

OPEN 
RENUMBER 
REROUTE 
RESET 
RESETROUTE 
RESUME 
RESUMEDEV 
START 
STARTDEV 
STOP 
STOPDEV 
SUPPRESS 
THRESHOLD 
TIMEREST 
TYPE 
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LOGUTIL commands 
DELDEVICE 
Purpose 
Use the DELDEVICE command to delete a device from the log system. 
Access 
>LOGUTIL 
Syntax 
>DELDEVICE io _ device 
Parameters 
The command parameters are described in Table 1-11. 
Table 1-11 


DELDEVICE parameter descriptions 


Parameter Values Description 
io_device The input/output (I/O) device to delete 
—end— 


Example command 


> 


Responses 
None 


Related commands 
The following commands are accessible in the LOGUTIL directory: 


e ADDCLASS 
e ADDREP 

e BACK 

e BACKUP 

e CLASS 

e CLEAR 

e CONTEXT 

e DELCLASS 
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LOGUTIL commands 
DELDEVICE (end) 


DELREP 
DUMPLOGS 
FIRST 
FORMAT 
FORWARD 
LAST 
LSITDEVS 
LISTLOGS 
LISTNODES 
LISTREPS 
LISTROUTE 
LISTTIME 
MODE 

OPEN 
RENUMBER 
REROUTE 
RESET 
RESETROUTE 
RESUME 
RESUMEDEV 
START 
STARTDEV 
STOP 
STOPDEV 
SUPPRESS 
THRESHOLD 
TIMEREST 
TYPE 
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LOGUTIL commands 


DELREP 


Purpose 


Use the DELREP command to delete report(s) from those reports handled 
by a specific device. 


Access 


>LOGUTIL 


Syntax 


>DELREP io_device logname repnum 


Parameters 


The command parameters are described in Table 1-12. 


Table 1-12 


DELREP parameter descriptions 


Parameter Values Description 

io_device The input/output (I/O) device that handles the 
report(s) 

logname The log name or names 

repnum The report number or numbers to delete 


—end— 


Example command 
>DELREP prt aud 107 


Responses 


None 


Related commands 
The following commands are accessible in the LOGUTIL directory: 


ADDCLASS 
ADDREP 
BACK 
BACKUP 
CLASS 
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LOGUTIL commands 
DELREP (continued) 


CLEAR 
CONTEXT 
DELCLASS 
DELDEVICE 
DUMPLOGS 
FIRST 
FORMAT 
FORWARD 
LAST 
LSITDEVS 
LISTLOGS 
LISTNODES 
LISTREPS 
LISTROUTE 
LISTTIME 
MODE 

OPEN 
RENUMBER 
REROUTE 
RESET 
RESETROUTE 
RESUME 
RESUMEDEV 
START 
STARTDEV 
STOP 
STOPDEV 
SUPPRESS 
THRESHOLD 
TIMEREST 
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LOGUTIL commands 
DELREP (end) 


e TYPE 
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LOGUTIL commands 


DUMPLOGS 
Purpose 
Use the DUMPLOGS command to display the log reports in a log buffer in 
chronological order as they were generated. 
Access 
>LOGUTIL 
Syntax 
>DUMPLOGS logname lognumber 
Parameters 
The command parameters are described in Table 1-13. 
Table 1-13 
DUMPLOGS parameter descriptions 
Parameter Values Description 
logname The log name or names 
lognumber Numeric; 0 to 999 The log number 
—end— 


Example command 
>DUMPLOGS aud 


Responses 
None 


Related commands 
The following commands are accessible in the LOGUTIL directory: 


e ADDCLASS 
e ADDREP 

e BACK 

e BACKUP 

e CLASS 

e CLEAR 

e CONTEXT 
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LOGUTIL commands 
DUMPLOGS (end) 


e DELCLASS 

e DELDEVICE 
e DELREP 

e FIRST 

e FORMAT 

e FORWARD 

e LAST 

e LSITDEVS 

e LISTLOGS 

e LISTNODES 

e LISTREPS 

e LISTROUTE 
e LISTTIME 

e MODE 

e OPEN 

e RENUMBER 
e REROUTE 

e RESET 

e RESETROUTE 
e RESUME 

e RESUMEDEV 
e START 

e STARTDEV 

e STOP 

e STOPDEV 

e SUPPRESS 

e THRESHOLD 
e TIMEREST 

e TYPE 
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LOGUTIL commands 


FIRST 

Purpose 

Use the FIRST command to print the first report entry. 
Access 

>LOGUTIL 
Syntax 

>FIRST 
Parameters 

None 


Example command 
>FIRST 


Responses 
None 


Related commands 
The following commands are accessible in the LOGUTIL directory: 


e ADDCLASS 
e ADDREP 

e BACK 

e BACKUP 

e CLASS 

e CLEAR 

e CONTEXT 

e DELCLASS 
e DELDEVICE 
e DELREP 

e DUMPLOGS 
e FORMAT 

e FORWARD 

e LAST 

e LSITDEVS 
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LOGUTIL commands 
FIRST (end) 


e LISTLOGS 

e LISTNODES 

e LISTREPS 

e LISTROUTE 
e LISTTIME 

e MODE 

e OPEN 

e RENUMBER 
e REROUTE 

e RESET 

e RESETROUTE 
e RESUME 

e RESUMEDEV 
e START 

e STARTDEV 

e STOP 

e STOPDEV 

e SUPPRESS 

e THRESHOLD 
e TIMEREST 

e TYPE 
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LOGUTIL commands 


FORMAT 
Purpose 
Use the FORMAT command to set and query the output format of the 
reports. 
Access 
>LOGUTIL 
Syntax 
>FORMAT normal | short 
Parameters 
The command parameters are described in Table 1-14. 
Table 1-14 


FORMAT parameter descriptions 


Parameter Values Description 

normal Prints the report(s) in normal format 

short Shows only the first line of the normal log report(s) 
—end— 


Example command 
>FORMAT short 


Responses 
None 


Related commands 
The following commands are accessible in the LOGUTIL directory: 


e ADDCLASS 
e ADDREP 

e BACK 

e BACKUP 

e CLASS 

e CLEAR 

e CONTEXT 
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LOGUTIL commands 
FORMAT (end) 


e DELCLASS 

e DELDEVICE 
e DELREP 

e DUMPLOGS 

e FIRST 

e FORWARD 

e LAST 

e LSITDEVS 

e LISTLOGS 

e LISTNODES 

e LISTREPS 

e LISTROUTE 

e LISTTIME 

e MODE 

e OPEN 

e RENUMBER 
e REROUTE 

e RESET 

e RESETROUTE 
e RESUME 

e RESUMEDEV 
e START 

e STARTDEV 

e STOP 

e STOPDEV 

e SUPPRESS 

e THRESHOLD 
e TIMEREST 

e TYPE 
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LOGUTIL commands 
FORWARD 
Purpose 
Use the FORWARD command to display the report entry after the current 
one. 
Access 
>LOGUTIL 
Syntax 
>FORWARD number | all 
Parameters 
The command parameters are described in Table 1-15. 
Table 1-15 


FORWARD parameter descriptions 


Parameter Values Description 
number Numeric; 1 to 32767. Specifies the number of reports you wish to display 
Default is 1. 
all Specifies the display of all reports after the current 
entry display 
—end— 


Example command 
>FORWARD 5 


Responses 
None 


Related commands 
The following commands are accessible in the LOGUTIL directory: 


e ADDCLASS 
e ADDREP 

e BACK 

e BACKUP 

e CLASS 
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LOGUTIL commands 
FORWARD (continued) 


e CLEAR 

e CONTEXT 

e DELCLASS 

e DELDEVICE 
e DELREP 

e DUMPLOGS 
e FIRST 

e FORMAT 

e LAST 

e LSITDEVS 

e LISTLOGS 

e LISTNODES 

e LISTREPS 

e LISTROUTE 
e LISTTIME 

e MODE 

e OPEN 

e RENUMBER 
e REROUTE 

e RESET 

e RESETROUTE 
e RESUME 

e RESUMEDEV 
e START 

e STARTDEV 

e STOP 

e STOPDEV 

e SUPPRESS 

e THRESHOLD 
e TIMEREST 
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LOGUTIL commands 
FORWARD (end) 


TYPE 
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LOGUTIL commands 


LAST 
Purpose 
Use the LAST command to print the last report entry. 
Access 
>LOGUTIL 
Syntax 
>LAST 
Parameters 
None 


Example command 
>LAST 


Responses 
None 


Related commands 
The following commands are accessible in the LOGUTIL directory: 


e ADDCLASS 
e ADDREP 

e BACK 

e BACKUP 

e CLASS 

e CLEAR 

e CONTEXT 

e DELCLASS 
e DELDEVICE 
e DELREP 

e DUMPLOGS 
e FIRST 

e FORMAT 

e FORWARD 
e LSITDEVS 
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LOGUTIL commands 
LAST (end) 


LISTLOGS 
LISTNODES 
LISTREPS 
LISTROUTE 
LISTTIME 
MODE 

OPEN 
RENUMBER 
REROUTE 
RESET 
RESETROUTE 
RESUME 
RESUMEDEV 
START 
STARTDEV 
STOP 
STOPDEV 
SUPPRESS 
THRESHOLD 
TIMEREST 
TYPE 
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LOGUTIL commands 
LISTDEVS 
Purpose 
Use the LISTDEVS command to list the input/output devices defined in the 
log system. 
Access 
>LISTDEVS 
Syntax 
>LISTDEVS brief | full 
Parameters 
The command parameters are described in Table 1-16. 
Table 1-16 
LISTDEVS parameter descriptions 
Parameter Values Description 
brief Specifies a brief report of the devices available. This 
parameter is the default. 
full Specifies a full report of the devices available. 
—end— 


Example command 
>LISTDEVS full 


Responses 
None 


Related commands 
The following commands are accessible in the LOGUTIL directory: 
e ADDCLASS 
e ADDREP 
e BACK 
e BACKUP 
e CLASS 
e CLEAR 
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LOGUTIL commands 
LISTDEVS (continued) 


CONTEXT 
DELCLASS 
DELDEVICE 
DELREP 
DUMPLOGS 
FIRST 
FORMAT 
FORWARD 
LAST 
LISTLOGS 
LISTNODES 
LISTREPS 
LISTROUTE 
LISTTIME 
MODE 

OPEN 
RENUMBER 
REROUTE 
RESET 
RESETROUTE 
RESUME 
RESUMEDEV 
START 
STARTDEV 
STOP 
STOPDEV 
SUPPRESS 
THRESHOLD 
TIMEREST 
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LOGUTIL commands 
LISTDEVS (end) 


e TYPE 
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LOGUTIL commands 


LISTLOGS 

Purpose 

Use the LISTLOGS command to list all the logs that have been defined. 
Access 

>LISTUTIL 
Syntax 

>LISTLOGS 
Parameters 

None 


Example command 
>LISTLOGS 


Responses 
None 


Related commands 
The following commands are accessible in the LOGUTIL directory: 


e ADDCLASS 
e ADDREP 

e BACK 

e BACKUP 

e CLASS 

e CLEAR 

e CONTEXT 

e DELCLASS 
e DELDEVICE 
e DELREP 

e DUMPLOGS 
e FIRST 

e FORMAT 

e FORWARD 

e LAST 
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LOGUTIL commands 
LISTLOGS (end) 


e LSITDEVS 

e LISTNODES 

e LISTREPS 

e LISTROUTE 
e LISTTIME 

e MODE 

e OPEN 

e RENUMBER 
e REROUTE 

e RESET 

e RESETROUTE 
e RESUME 

e RESUMEDEV 
e START 

e STARTDEV 

e STOP 

e STOPDEV 

e SUPPRESS 

e THRESHOLD 
e TIMEREST 

e TYPE 
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LOGUTIL commands 


LISTNODES 

Purpose 

Use the LISTNODES command to list all the nodes in the switch. 
Access 

>LOGUTIL 
Syntax 

>LISTNODES 
Parameters 

None 


Example command 
>LISTNODES 


Responses 
None 


Related commands 
The following commands are accessible in the LOGUTIL directory: 


e ADDCLASS 
e ADDREP 

e BACK 

e BACKUP 

e CLASS 

e CLEAR 

e CONTEXT 

e DELCLASS 
e DELDEVICE 
e DELREP 

e DUMPLOGS 
e FIRST 

e FORMAT 

e FORWARD 

e LAST 
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LOGUTIL commands 
LISTNODES (end) 


e LSITDEVS 

e LISTLOGS 

e LISTREPS 

e LISTROUTE 
e LISTTIME 

e MODE 

e OPEN 

e RENUMBER 
e REROUTE 

e RESET 

e RESETROUTE 
e RESUME 

e RESUMEDEV 
e START 

e STARTDEV 

e STOP 

e STOPDEV 

e SUPPRESS 

e THRESHOLD 
e TIMEREST 

e TYPE 
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LOGUTIL commands 


LISTREPS 
Purpose 
Use the LISTREPS command to list all report types for a selected log or 
class. 
Note: Unless you use specific report types, this command may take several 
minutes to execute. 
Access 
>LOGUTIL 
Syntax 
>LISTREPS special | syslog logname | class repnum | classnum 
Parameters 
The command parameters are described in Table 1-17. 
Table 1-17 
LISTREPS parameter descriptions 
Parameter Values Description 
special Lists only the suppressed and threshold reports 
syslog Lists only the syslog reports 
logname The log name or names for which to list reports 
class Specifies the number that follows is a class of report 
repnum The report number or numbers to list 
classnum Numeric; 0 to 31 The class number 
—end— 


Example command 
>LISTREPS rman 131 


Responses 
None 


Related commands 
The following commands are accessible in the LOGUTIL directory: 


e ADDCLASS 
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LOGUTIL commands 
LISTREPS (continued) 


e ADDREP 

e BACK 

e BACKUP 

e CLASS 

e CLEAR 

e CONTEXT 

e DELCLASS 

e DELDEVICE 
e DELREP 

e DUMPLOGS 
e FIRST 

e FORMAT 

e FORWARD 

e LAST 

e LSITDEVS 

e LISTLOGS 

e LISTNODES 
e LISTROUTE 
e LISTTIME 

e MODE 

e OPEN 

e RENUMBER 
e REROUTE 

e RESET 

e RESETROUTE 
e RESUME 

e RESUMEDEV 
e START 

e STARTDEV 

e STOP 
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LOGUTIL commands 
LISTREPS (end) 


STOPDEV 
SUPPRESS 
THRESHOLD 
TIMEREST 
TYPE 
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LOGUTIL commands 
LISTROUTE 
Purpose 
Use the LISTROUTE command to list routing information. 
Access 
>LOGUTIL 
Syntax 
>LISTROUTE device / class / report 
Parameters 
The command parameters are described in Table 1-18. 
Table 1-18 
LISTROUTE parameter descriptions 
Parameter Values Description 
device Specifies the routing for devices 
io_device The device or devices 
class Specifies the routing for a class of reports 
classnum The class number or numbers, from 0 to 31 
report Specifies the routing for reports 
logname The log name or names 
repnum The report number or numbers 
—end— 


Example command 
>LISTROUTE report iod 120 


Responses 


None 


Related commands 
The following commands are accessible in the LOGUTIL directory: 


e ADDCLASS 
e ADDREP 
e BACK 
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LOGUTIL commands 
LISTROUTE (continued) 


BACKUP 
CLASS 
CLEAR 
CONTEXT 
DELCLASS 
DELDEVICE 
DELREP 
DUMPLOGS 
FIRST 
FORMAT 
FORWARD 
LAST 
LSITDEVS 
LISTLOGS 
LISTNODES 
LISTREPS 
LISTTIME 
MODE 
OPEN 
RENUMBER 
REROUTE 
RESET 
RESETROUTE 
RESUME 
RESUMEDEV 
START 
STARTDEV 
STOP 
STOPDEV 
SUPPRESS 
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LOGUTIL commands 
LISTROUTE (end) 


e THRESHOLD 
e TIMEREST 
e TYPE 
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LOGUTIL commands 
LISTTIME 


Purpose 


Access 
Syntax 


Parameters 


Use the LISTTIME command to list the reports that are on the reset 
schedule. 


>LOGUTIL 


>LISTTIME 


None 


Example command 


Responses 


>LISTTIME 


None 


Related commands 


The following commands are accessible in the LOGUTIL directory: 
e ADDCLASS 
e ADDREP 

e BACK 

e BACKUP 

e CLASS 

e CLEAR 

e CONTEXT 

e DELCLASS 

e DELDEVICE 
e DELREP 

e DUMPLOGS 
e FIRST 

e FORMAT 

e FORWARD 

e LAST 
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LOGUTIL commands 
LISTTIME (end) 


e LSITDEVS 

e LISTLOGS 

e LISTNODES 

e LISTREPS 

e LISTROUTE 
e MODE 

e OPEN 

e RENUMBER 
e REROUTE 

e RESET 

e RESETROUTE 
e RESUME 

e RESUMEDEV 
e START 

e STARTDEV 

e STOP 

e STOPDEV 

e SUPPRESS 

e THRESHOLD 
e TIMEREST 

e TYPE 
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LOGUTIL commands 


MODE 
Purpose 
Use the MODE command to set the query mode of logs for use with the 
browsing commands. You may set the mode when you enter the LOGUTIL 
directory or when you run the mode command during the session. 
Access 
>LOGUTIL 
Syntax 
>MODE craft | expert 
Parameters 
The command parameters are described in Table 1-19. 
Table 1-19 
MODE parameter descriptions 
Parameter Values Description 
craft Specifies only craft logs are available for display. The 
mode is set to craft when you enter the LOGUTIL 
directory. 
expert Specifies all logs are available for display. 
—end— 


Example command 
>MODE expert 


Responses 


None 


Related commands 
The following commands are accessible in the LOGUTIL directory: 


e ADDCLASS 
e ADDREP 

e BACK 

e BACKUP 

e CLASS 
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LOGUTIL commands 
MODE (continued) 


e CLEAR 

e CONTEXT 

e DELCLASS 

e DELDEVICE 
e DELREP 

e DUMPLOGS 
e FIRST 

e FORMAT 

e FORWARD 

e LAST 

e LSITDEVS 

e LISTLOGS 

e LISTNODES 

e LISTREPS 

e LISTROUTE 
e LISTTIME 

e OPEN 

e RENUMBER 
e REROUTE 

e RESET 

e RESETROUTE 
e RESUME 

e RESUMEDEV 
e START 

e STARTDEV 

e STOP 

e STOPDEV 

e SUPPRESS 

e THRESHOLD 
e TIMEREST 
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LOGUTIL commands 
MODE (end) 


TYPE 
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LOGUTIL commands 
OPEN 
Purpose 
Use the OPEN command to prepare a log buffer for display. 
Access 
>LOGUTIL 
Syntax 
>OPEN first | logname lognumber 
Parameters 
The command parameters are described in Table 1-20. 
Table 1-20 


OPEN parameter descriptions 


Parameter Values Description 


first 
logname 


lognumber 


Specifies the first log in the buffer as a default 
Specifies the log name or names to display 


Specifies the log report number to display 


—end— 


Example command 
>OPEN aud 120 


Responses 
None 


Related commands 


The following commands are accessible in the LOGUTIL directory: 


e ADDCLASS 
e ADDREP 

e BACK 

e BACKUP 

e CLASS 

e CLEAR 
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LOGUTIL commands 
OPEN (continued) 


CONTEXT 
DELCLASS 
DELDEVICE 
DELREP 
DUMPLOGS 
FIRST 
FORMAT 
FORWARD 
LAST 
LSITDEVS 
LISTLOGS 
LISTNODES 
LISTREPS 
LISTROUTE 
LISTTIME 
MODE 
RENUMBER 
REROUTE 
RESET 
RESETROUTE 
RESUME 
RESUMEDEV 
START 
STARTDEV 
STOP 
STOPDEV 
SUPPRESS 
THRESHOLD 
TIMEREST 
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LOGUTIL commands 
OPEN (end) 


e TYPE 
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LOGUTIL commands 
RENUMBER 


Purpose 


Access 
Syntax 


Parameters 


Use the RENUMBER command to assign report numbers to all reports 
without one. 


>LOGUTIL 


>RENUMBER 


None 


Example command 


Responses 


>RENUMBER 


None 


Related commands 


The following commands are accessible in the LOGUTIL directory: 
e ADDCLASS 
e ADDREP 

e BACK 

e BACKUP 

e CLASS 

e CLEAR 

e CONTEXT 

e DELCLASS 

e DELDEVICE 
e DELREP 

e DUMPLOGS 
e FIRST 

e FORMAT 

e FORWARD 

e LAST 
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LOGUTIL commands 
RENUMBER (end) 


e LSITDEVS 

e LISTLOGS 

e LISTNODES 

e LISTREPS 

e LISTROUTE 
e LISTTIME 

e MODE 

e OPEN 

e REROUTE 

e RESET 

e RESETROUTE 
e RESUME 

e RESUMEDEV 
e START 

e STARTDEV 

e STOP 

e STOPDEV 

e SUPPRESS 

e THRESHOLD 
e TIMEREST 

e TYPE 
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LOGUTIL commands 


REROUTE 
Purpose 
Use the REROUTE command to reroute the specified devices to their 
backups. 
Access 
>LOGUTIL 
Syntax 
>REROUTE English | lang io_dev 
Parameters 
The command parameters are described in Table 1-21. 
Table 1-21 


REROUTE parameter descriptions 


Parameter Values Description 
English Specifies the report is printed in English as a default 
lang Specifies the report is printed in a language other 
than English 
io_device Specifies the output device 
—end— 


Example command 
>REROUTE d000scratch 


Responses 
None 


Related commands 
The following commands are accessible in the LOGUTIL directory: 
e ADDCLASS 
e ADDREP 
e BACK 
e BACKUP 
e CLASS 
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LOGUTIL commands 
REROUTE (continued) 


e CLEAR 

e CONTEXT 

e DELCLASS 

e DELDEVICE 
e DELREP 

e DUMPLOGS 
e FIRST 

e FORMAT 

e FORWARD 

e LAST 

e LSITDEVS 

e LISTLOGS 

e LISTNODES 

e LISTREPS 

e LISTROUTE 
e LISTTIME 

e MODE 

e OPEN 

e RENUMBER 
e RESET 

e RESETROUTE 
e RESUME 

e RESUMEDEV 
e START 

e STARTDEV 

e STOP 

e STOPDEV 

e SUPPRESS 

e THRESHOLD 
e TIMEREST 
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LOGUTIL commands 
REROUTE (end) 


TYPE 
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LOGUTIL commands 


RESET 
Purpose 
Use the RESET command to reset all thresholds and turn off all suppression. 
Access 
>LOGUTIL 
Syntax 
>RESET 
Parameters 
None 


Example command 
>RESET 


Responses 
None 


Related commands 
The following commands are accessible in the LOGUTIL directory: 


e ADDCLASS 
e ADDREP 

e BACK 

e BACKUP 

e CLASS 

e CLEAR 

e CONTEXT 

e DELCLASS 
e DELDEVICE 
e DELREP 

e DUMPLOGS 
e FIRST 

e FORMAT 

e FORWARD 

e LAST 


297-2621-819 Standard 14.01 April 2002 


Commands 2-75 


LOGUTIL commands 
RESET (end) 


LSITDEVS 
LISTLOGS 
LISTNODES 
LISTREPS 
LISTROUTE 
LISTTIME 
MODE 

OPEN 
RENUMBER 
REROUTE 
RESETROUTE 
RESUME 
RESUMEDEV 
START 
STARTDEV 
STOP 
STOPDEV 
SUPPRESS 
THRESHOLD 
TIMEREST 
TYPE 
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LOGUTIL commands 
RESETROUTE 


Purpose 


Use the RESETROUTE command to reset all the routing information from 
the LOGCLASS and LOGDEYV tables. 


WARNING 

Loss of temporary routing 

When you execute the RESETROUTE command, you 
will lose all temporary routing from CLASS, 
ADDCLASS, DELCLASS, and REROUTE commands. 


Access 

>LOGUTIL 
Syntax 

>RESETROUTE 
Parameters 

None 


Example command 
>RESETROUTE 


Responses 
None 


Related commands 
The following commands are accessible in the LOGUTIL directory: 


e ADDCLASS 
e ADDREP 

e BACK 

e BACKUP 

e CLASS 

e CLEAR 

e CONTEXT 

e DELCLASS 

e DELDEVICE 
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LOGUTIL commands 
RESETROUTE (end) 


DELREP 
DUMPLOGS 
FIRST 
FORMAT 
FORWARD 
LAST 
LSITDEVS 
LISTLOGS 
LISTNODES 
LISTREPS 
LISTROUTE 
LISTTIME 
MODE 
OPEN 
RENUMBER 
REROUTE 
RESET 
RESUME 
RESUMEDEV 
START 
STARTDEV 
STOP 
STOPDEV 
SUPPRESS 
THRESHOLD 
TIMEREST 
TYPE 
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LOGUTIL commands 
RESUME 
Purpose 
Use the RESUME command to resume generating selected reports. 
Access 
>LOGUTIL 
Syntax 
>RESUME logname repnum 
Parameters 
The command parameters are described in Table 1-22. 
Table 1-22 


RESUME parameter descriptions 


Parameter Values Description 
logname The log name 
repnum The report number 


—end— 


Example command 
>RESUME iod 120 


Responses 


None 


Related commands 
The following commands are accessible in the LOGUTIL directory: 


ADDCLASS 
ADDREP 
BACK 
BACKUP 
CLASS 
CLEAR 
CONTEXT 
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LOGUTIL commands 
RESUME (end) 


DELCLASS 
DELDEVICE 
DELREP 
DUMPLOGS 
FIRST 
FORMAT 
FORWARD 
LAST 
LSITDEVS 
LISTLOGS 
LISTNODES 
LISTREPS 
LISTROUTE 
LISTTIME 
MODE 

OPEN 
RENUMBER 
REROUTE 
RESET 
RESETROUTE 
RESUMEDEV 
START 
STARTDEV 
STOP 
STOPDEV 
SUPPRESS 
THRESHOLD 
TIMEREST 
TYPE 
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LOGUTIL commands 
RESUMEDEV 
Purpose 
Use the RESUMEDEV command to resume printing logs at a particular 
device. 
Access 
>LOGUTIL 
Syntax 
>RESUMEDEV cm | allnodes io dev 
Parameters 
The command parameters are described in Table 1-27. 
Table 1-23 


RESUMEDEV parameter descriptions 


Parameter Values Description 

cm Specifies reports from the central node as a default 

allnodes Specifies that logs generated on all nodes print on 
the given device(s) 

io_device Specifies the device where printing is to occur 


—end— 


Example command 
>RESUMEDEV allnodes rp121 


Responses 


None 


Related commands 
The following commands are accessible in the LOGUTIL directory: 


ADDCLASS 
ADDREP 
BACK 
BACKUP 
CLASS 
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LOGUTIL commands 
RESUMEDEV (continued) 


CLEAR 
CONTEXT 
DELCLASS 
DELDEVICE 
DELREP 
DUMPLOGS 
FIRST 
FORMAT 
FORWARD 
LAST 
LSITDEVS 
LISTLOGS 
LISTNODES 
LISTREPS 
LISTROUTE 
LISTTIME 
MODE 
OPEN 
RENUMBER 
REROUTE 
RESET 
RESETROUTE 
RESUME 
START 
STARTDEV 
STOP 
STOPDEV 
SUPPRESS 
THRESHOLD 
TIMEREST 
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LOGUTIL commands 
RESUMEDEV (end) 


e TYPE 
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LOGUTIL commands 


START 
Purpose 
Use the START command to start printing reports on this terminal as they 
are generated. 
Access 
>LOGUTIL 
Syntax 
>START ascii | ebcdic class 
Parameters 
The command parameters are described in Table 1-24. 
Table 1-24 


START parameter descriptions 


Parameter Values Description 
ascii Specifies reports are generated in ASCII as a default 
ebcdic Specifies reports are generated in EBCDIC 
class Numeric; 0 to 31 The class of report 
—end— 


Example command 
>START 2 


Responses 
None 


Related commands 
The following commands are accessible in the LOGUTIL directory: 


e ADDCLASS 
e ADDREP 

e BACK 

e BACKUP 

e CLASS 

e CLEAR 
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LOGUTIL commands 
START (continued) 


e CONTEXT 

e DELCLASS 

e DELDEVICE 
e DELREP 

e DUMPLOGS 
e FIRST 

e FORMAT 

e FORWARD 

e LAST 

e LSITDEVS 

e LISTLOGS 

e LISTNODES 

e LISTREPS 

e LISTROUTE 
e LISTTIME 

e MODE 

e OPEN 

e RENUMBER 
e REROUTE 

e RESET 

e RESETROUTE 
e RESUME 

e RESUMEDEV 
e STARTDEV 

e STOP 

e STOPDEV 

e SUPPRESS 

e THRESHOLD 
e TIMEREST 
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LOGUTIL commands 
START (end) 


TYPE 
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LOGUTIL commands 
STARTDEV 
Purpose 
Use the STARTDEV command to start printing reports at certain device(s). 
Access 
>LOGUTIL 
Syntax 
>STARTDEV ascii | ebcdic English | lang central | allnodes io_dev 
Parameters 
The command parameters are described in Table 1-25. 
Table 1-25 
STARTDEV parameter descriptions 
Parameter Values Description 
ascii Specifies the log data is recorded in ASCII as a 
default 
ebcdic Specifies the log data is recorded in EBCDIC 
English Specifies the report is printed in English as a default 
lang Specifies the report is printed in a language other 
than English 
central The central node logs are printed as a default 
io_device The output device(s) for the logs 
—end— 


Example command 
>STARTDEV all nodes rp121 


Responses 
None 


Related commands 
The following commands are accessible in the LOGUTIL directory: 


e ADDCLASS 
e ADDREP 
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LOGUTIL commands 
STARTDEV (continued) 


BACK 
BACKUP 
CLASS 
CLEAR 
CONTEXT 
DELCLASS 
DELDEVICE 
DELREP 
DUMPLOGS 
FIRST 
FORMAT 
FORWARD 
LAST 
LSITDEVS 
LISTLOGS 
LISTNODES 
LISTREPS 
LISTROUTE 
LISTTIME 
MODE 
OPEN 
RENUMBER 
REROUTE 
RESET 
RESETROUTE 
RESUME 
RESUMEDEV 
START 
STOP 
STOPDEV 


Digital Switching Systems UCS DMS-250 Commands Reference Manual UCS17 


2-88 Commands 


LOGUTIL commands 
STARTDEV (end) 


e SUPPRESS 

e THRESHOLD 
e TIMEREST 

e TYPE 
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LOGUTIL commands 


STOP 

Purpose 

Use the STOP command to stop printing reports on the current device. 
Access 

>LOGUTIL 
Syntax 

>STOP 
Parameters 

None 


Example command 
>STOP 


Responses 
None 


Related commands 
The following commands are accessible in the LOGUTIL directory: 


e ADDCLASS 
e ADDREP 

e BACK 

e BACKUP 

e CLASS 

e CLEAR 

e CONTEXT 

e DELCLASS 
e DELDEVICE 
e DELREP 

e DUMPLOGS 
e FIRST 

e FORMAT 

e FORWARD 

e LAST 


Digital Switching Systems UCS DMS-250 Commands Reference Manual UCS17 


2-90 Commands 


LOGUTIL commands 
STOP (end) 


e LSITDEVS 

e LISTLOGS 

e LISTNODES 

e LISTREPS 

e LISTROUTE 
e LISTTIME 

e MODE 

e OPEN 

e RENUMBER 
e REROUTE 

e RESET 

e RESETROUTE 
e RESUME 

e RESUMEDEV 
e START 

e STARTDEV 

e STOPDEV 

e SUPPRESS 

e THRESHOLD 
e TIMEREST 

e TYPE 
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STOPDEV 
Purpose 
Use the STOPDEV command to stop printing reports at specific device(s). 
Access 
>LOGUTIL 
Syntax 
>STOPDEV central | allnodes io_dev 
Parameters 
The command parameters are described in Table 1-26. 
Table 1-26 
STOPDEV parameter descriptions 
Parameter Values Description 
central Specifies the central node logs are printed, as a 
default 
allnodes Specifies the logs from all nodes are stopped on the 
given device(s) 
io_device The output device(s) for the log reports 
—end— 


Example command 
>STOPDEV all nodes rp121 


Responses 
None 


Related commands 
The following commands are accessible in the LOGUTIL directory: 


e ADDCLASS 
e ADDREP 

e BACK 

e BACKUP 

e CLASS 
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STOPDEV (continued) 


e CLEAR 

e CONTEXT 

e DELCLASS 

e DELDEVICE 
e DELREP 

e DUMPLOGS 
e FIRST 

e FORMAT 

e FORWARD 

e LAST 

e LSITDEVS 

e LISTLOGS 

e LISTNODES 

e LISTREPS 

e LISTROUTE 
e LISTTIME 

e MODE 

e OPEN 

e RENUMBER 
e REROUTE 

e RESET 

e RESETROUTE 
e RESUME 

e RESUMEDEV 
e START 

e STARTDEV 

e STOP 

e SUPPRESS 

e THRESHOLD 
e TIMEREST 


297-2621-819 Standard 14.01 April 2002 


Commands 2-93 


LOGUTIL commands 
STOPDEV (end) 


TYPE 
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SUPPRESS 
Purpose 
Use the SUPPRESS command to stop generating selected reports. 
Access 
>LOGUTIL 
Syntax 
>SUPPRESS logname repnum 
Parameters 
The command parameters are described in Table 1-27. 
Table 1-27 


SUPPRESS parameter descriptions 


Parameter Values Description 

logname The log name or names 

repnum The report number or numbers 
—end— 


Example command 
>SUPPRESS cm 108 


Responses 
None 


Related commands 
The following commands are accessible in the LOGUTIL directory: 


e ADDCLASS 
e ADDREP 

e BACK 

e BACKUP 

e CLASS 

e CLEAR 

e CONTEXT 
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SUPPRESS (end) 


DELCLASS 
DELDEVICE 
DELREP 
DUMPLOGS 
FIRST 
FORMAT 
FORWARD 
LAST 
LSITDEVS 
LISTLOGS 
LISTNODES 
LISTREPS 
LISTROUTE 
LISTTIME 
MODE 

OPEN 
RENUMBER 
REROUTE 
RESET 
RESETROUTE 
RESUME 
RESUMEDEV 
START 
STARTDEV 
STOP 
STOPDEV 
THRESHOLD 
TIMEREST 
TYPE 
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THRESHOLD 
Purpose 
Use the THRESHOLD command to set the threshold for selected reports. 
Access 
>LOGUTIL 
Syntax 
>THRESHOLD threshold logname repnum 
Parameters 
The command parameters are described in Table 1-28. 
Table 1-28 
THRESHOLD parameter descriptions 
Parameter Values Description 
threshold The threshold value 
logname The log name or names 
repnum The report number or numbers 
—end— 


Example command 
>THRESHOLD 4 cm 108 


Responses 
None 


Related commands 
The following commands are accessible in the LOGUTIL directory: 


e ADDCLASS 
e ADDREP 

e BACK 

e BACKUP 

e CLASS 

e CLEAR 
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LOGUTIL commands 
THRESHOLD (continued) 


CONTEXT 
DELCLASS 
DELDEVICE 
DELREP 
DUMPLOGS 
FIRST 
FORMAT 
FORWARD 
LAST 
LSITDEVS 
LISTLOGS 
LISTNODES 
LISTREPS 
LISTROUTE 
LISTTIME 
MODE 
OPEN 
RENUMBER 
REROUTE 
RESET 
RESETROUTE 
RESUME 
RESUMEDEV 
START 
STARTDEV 
STOP 
STOPDEV 
SUPPRESS 
TIMEREST 
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THRESHOLD (end) 


e TYPE 
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LOGUTIL commands 


TIMERESET 
Purpose 
Use the TIMERESET command to periodically reset report counts for the 
threshold. 
Access 
>LOGUTIL 
Syntax 
>TIMERESET minutes logname repnum 
Parameters 
The command parameters are described in Table 1-29. 
Table 1-29 
TIMERESET parameter descriptions 
Parameter Values Description 
minutes The minutes to wait before resetting the report count 
logname The log name or names 
repnum The report number or numbers 
—end— 


Example command 
>TIMERESET 1 cm 108 


Responses 
None 


Related commands 
The following commands are accessible in the LOGUTIL directory: 


e ADDCLASS 
e ADDREP 

e BACK 

e BACKUP 

e CLASS 

e CLEAR 
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TIMERESET (continued) 


e CONTEXT 

e DELCLASS 

e DELDEVICE 
e DELREP 

e DUMPLOGS 
e FIRST 

e FORMAT 

e FORWARD 

e LAST 

e LSITDEVS 

e LISTLOGS 

e LISTNODES 

e LISTREPS 

e LISTROUTE 
e LISTTIME 

e MODE 

e OPEN 

e RENUMBER 
e REROUTE 

e RESET 

e RESETROUTE 
e RESUME 

e RESUMEDEV 
e START 

e STARTDEV 

e STOP 

e STOPDEV 

e SUPPRESS 

e THRESHOLD 


297-2621-819 Standard 14.01 April 2002 


Commands 2-101 


LOGUTIL commands 
TIMERESET (end) 


TYPE 
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TYPE 
Purpose 
Use the TYPE command to print the current report entry. 
Access 
>LOGUTIL 
Syntax 
>TYPE 
Parameters 
None 


Example command 
>TYPE 


Responses 
None 


Related commands 
The following commands are accessible in the LOGUTIL directory: 


e ADDCLASS 
e ADDREP 

e BACK 

e BACKUP 

e CLASS 

e CLEAR 

e CONTEXT 

e DELCLASS 
e DELDEVICE 
e DELREP 

e DUMPLOGS 
e FIRST 

e FORMAT 

e FORWARD 

e LAST 

e LSITDEVS 
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TYPE (end) 


LISTLOGS 
LISTNODES 
LISTREPS 
LISTROUTE 
LISTTIME 
MODE 

OPEN 
RENUMBER 
REROUTE 
RESET 
RESETROUTE 
RESUME 
RESUMEDEV 
START 
STARTDEV 
STOP 
STOPDEV 
SUPPRESS 
THRESHOLD 
TIMEREST 
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MVMEMBER directory 
MVMEMBER (end) 


Purpose 
MVMEMBERR accesses the MVMEMBER directory. 


Access 
All MVMEMBER commands are accessed through the following command: 


>MAPCI;MTC;TRKS;TTP;LEVEL FLEXCONV;MVMEMBER 
Related commands 
The following commands are accessible in the MVMEMBER directory: 
e MVMEMBER HALTMV 
e MVMEMBER MOVE 
e MVMEMBER QUERYMV 
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HALTMV 
Purpose 
Use the HALTMV command to abort a MOVE command that is in progress. 
This command stops the process of moving trunk group members from the 
original trunk group to the new trunk group. HALTMV only stops the 
process, it does not move trunk group members back to the original trunk 
group. 
Access 
>MAPCI;MTC;TRKS;TTP;LEVEL FLEXCONV;MVMEMBER 
Syntax 
>HALTMV OLDGRP STRING OLD trunk group name 
Parameters 
The command parameters are listed in Table 1-30. 
Table 1-30 
HALTMV parameter description 
Parameter Values Description 
OLDGRP CLLI OLD trunk group name 
—end— 


Example command 
>HALTMV OLDGRP1 
Movement of trunks from OLDGRP1 is halted. 


Responses 
The following are possible responses to the HALTMV command. 
Movement of trunks from <clli> is halted 
Explanation: 


The switch has stopped moving trunk group members. 


System action: 
None 


User action: 
None 
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HALTMV (end) 


Error messages 


The following error messages may display as a result of the HALTMV 
command. 


Error: CLLI <clli> is not valid 


Explanation: 
Occurs if the system does not recognize the CLLI. 


System action: 
None 


User action: 
Verify the CLLI name. If a valid name has not been specified, verify 
the trunk group definition. 


The group <clli> is not being processed. 
Explanation: 
Occurs if the switch is not processing the specified trunk group. 
There is nothing for the switch to halt. 


System action: 
None 


User action: 
Verify the trunk group parameter is correct. Check for log report 
FLTKCV302 to see if the switch completed the request. 


Related commands 


Use the HALTMV and QUERYMV commands to stop and query the 
process when using the MOVE command. 
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MOVE 
Purpose 
Use the MOVE command to start a process of moving trunk members from 
the old trunk group to the new trunk group. You can stop or query this 
process at any time, by using the HALTMV or QUERYMV commands. 
Access 
>MAPCI;MTC;TRKS;TTP;LEVEL FLEXCONV;MVMEMBER 
Syntax 
>MOVE OLDGRP STRING OLD trunk group name 
>NEWGRP STRING NEW trunk group name 
>PERCENT 1 to 100 
Parameters 
The command parameters are described in Table 1-31. 
Table 1-31 
MOVE parameter descriptions 
Parameter Values Description 
OLDGRP CLLI OLD trunk group name 
NEWGRP CLLI NEW trunk group name 
PERCENT Numeric; 1 to 100 Percentage of trunk group members to move 
—end— 


Example command 
>MOVE OLDGRP1 NEWGRP1 
Movement process has started 
Responses 
The following are possible responses by the UCS DMS-250 switch. 


Movement process has started 


Explanation: 
The members of the old trunk group have started to be moved to the 
new trunk group. The verification has been completed successfully. 
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MVMEMBER commands 


MOVE (continued) 


System action: 
Moving the members from the old trunk group to the new trunk 
group. 


User action: 
Wait for a log report FLCV302 specifying that the request has been 
completed successfully or execute the QUERYMV command. 


Warning messages 
The following are possible warning messages by the UCS DMS-250 switch. 


Warning: EXTNUMS are differentChange <new clli> EXTNUM to 
match <old clli> YES/NO 


Explanation: 

Occurs when the old and the new trunk groups have different 
EXTNUMS. You have the option to change the EXTNUM of the 
new trunk group to match the one of the old trunk group. 


System action: 
Waits for you to enter YES or NO. 


User action: 
If you want to change the extnums of the new trunk group, answer 
YES to execute the request. Otherwise enter NO. 


Warning: Moving all trunk members at once could cause 
disruption of trafficDo you want to proceed? YES/NO 


Explanation: 

Occurs if you try to move 100 percent of the trunk members. If you 
move all the members of the trunk group at one time, you can disrupt 
the traffic on this trunk group. 


System action: 
Waits for you to enter YES or NO. 


User action: 

If you want to proceed, type YES. Otherwise, type NO and 
re-execute the command with lower percentage of the trunk members 
you want to move. 
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MOVE (continued) 


Error messages 


The following error messages may display as a result of the MOVE 
command. 


Error: 


Error: 


Error: 


Error: 


Another conversion request is being processed 


Explanation: 
Occurs when the switch is processing a conversion request from 
another user. 


System action: 
None 


User action: 
Wait until the switch completes the other request. 


CLLI <clli> is not valid 


Explanation: 
Occurs if the old trunk group name or the new trunk group name that 
you entered as a parameter is not recognized by the system. 


System action: 
None 


User action: 
Verify the CLLI names. If valid names have been specified, verify 
the trunk group definitions. 


Error: Cannot convert SS7 trunks to PTS. 


Explanation: 
Occurs if you try to convert SS7 trunk groups to PTS trunk groups. 
This command cannot convert SS7 to PTS. 


System action: 
None 


User action: 
Check specified parameters. 


The <clli> group has no members to move 


Explanation: 
Occurs if the old trunk group has no members to move. 
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MOVE (end) 


Error: 


System action: 
None 


User action: 
Check the specified parameters. 


Use the TRKCONV to convert the PTS trunk to SS7 


Explanation: 

Occurs when you attempt to convert PTS trunk groups to SS7 trunk 
groups. You can use command to convert SS7 trunk groups to SS7 
AXXESS trunk groups. However, you must convert PTS trunk 
groups to SS7 by using the TRKCONV tool. Then use the 
FLEXCONV tool to convert the SS7 trunk groups. 


System action: 
None 


User action: 
Enter the TRKCONYV level under the TTP level and convert the PTs 
trunk group to SS7. Then execute the MOVE command again. 


Related commands 


Use the HALTMV and QUERYMV commands to stop and query the 
process when using the MOVE command. 


297-2621-819 Standard 14.01 April 2002 


Commands 2-111 


MVMEMBER commands 
QUERYMV 
Purpose 
Use the QUERYMV command to query whether the movement of trunk 
group members is in progress. If this is the case, QUERYMV displays the 
amount of members that have been moved and the amount remaining to be 
moved. 
Access 
>MAPCI;MTC;TRKS;TTP;LEVEL FLEXCONV;MVMEMBER 
Syntax 
>QUERYMV OLDGRP STRING OLD trunk group name 
Parameters 
The command parameters are listed in Table 1-32. 
Table 1-32 
QUERYMV parameter description 
Parameter Value Description 
OLDGRP CLLI OLD trunk group name 
—end— 


Example command 
>QUERYMV OLDGRP 
Error: CLLI OLDGRP is not valid. 


Responses 
The following are the possible responses by the UCS DMS-250 switch. 


<number> members have been moved 
<number> members remain to be moved 


Explanation: 
Specifies the switch is still processing the request. 


System action: 
None 


User action: 
Wait until the switch completes the process. 
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QUERYMV (end) 


Error messages 


The following error messages may display as a result of the QUERYMV 
command. 


Error: CLLI <clli> is not valid 


Explanation: 
Occurs if the system does not recognize the CLLI. 


System action: 
None 


User action: 
Verify the CLLI name. If a valid name has not been specified, verify 
the trunk group definition. 


The group <clli> is not being processed. 


Explanation: 

Occurs if the switch is not processing the specified trunk group. It 
could be that the switch completed the process, or that it never 
started it. 


System action: 
None 


User action: 
Check for the LOG report FLCV302 to see if the switch completed 
the request. 


Related commands 


Use the QUERYMV and HALTMV commands to stop and query the 
process when using the MOVE command. 
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NETSEC directory 
NETSEC 


Purpose 


The Network Security (NETSEC) command is used to monitor suspected 
fraud calls. A NET601 log or a CDR is generated to identify originating 
trunk agencies on answered calls that are monitored by the NETSEC option. 
A NET603 log or a CDR is generated to identify terminating trunk agencies 
on answered calls that are monitored by the NETSEC option. 


The NETSEC option is a function of table TRKGRP. This option is provided 
on the following trunk agencies: PTS FGD, SS7 FGD, PRI, DAL, SS7 Inter 
IMT, Q.767 Global IMT, ISUP92 Global IMT, and PTS IMT trunk groups. 


By using the NETSEC CI commands, the Network Security function can be 
turned on and off without entering table TRKGRP. These commands allow 
you to 


e add the NETSEC option to an originating or terminating trunk 
e remove the NETSEC option from an originating or terminating trunk 


e enable/disable fraud profile screening 


The NETSEC command also provides reports that display the following: 
e the active calls that are possible fraud calls 

e the active NETSEC trunk groups 

e the NETSEC status (ON or OFF) of a specific NETSEC CLLI 


Note: NETSEC CLLI refers to the type of trunk supported by NETSEC 
functionality: Direct Access Line (DAL), Equal Access Network Trunk 
(EANT), Primary Rate Interface (PRI), and Inter-machine Trunk (IMT). 


Note: EANT includes Signaling System 7 (SS7) or Per Trunk Signaling 
(PTS). 


Restrictions 
The NETSEC command does not support AXXESS trunks. 


Access 
>NETSEC 


Syntax 
>NETSEC 
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NETSEC directory 
NETSEC (end) 


Parameters 
None. 


Example command 
>NETSEC 


Responses 
None. 


Related commands 
The following commands are accessible through the NETSEC directory: 
e SET 
e LIST 
e LISTFRAUD 
e HELP 
e QUIT 
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SET 
Purpose 
The Set (SET) command activates or deactivates the Network Security 
(NETSEC) function for originating, terminating, and two-way agencies. The 
NETSEC option can be set on the following agencies: DAL, PTS EANT, 
SS7 EANT, PRI, SS7 Inter IMT, Q.767 Global IMT, ISUP92 Global IMT, 
and PTS IMT. 
Access 
>NETSEC 
Syntax 
>SET <c11i> ORIG/TERM OFF/{0 TO 255} 
Parameters 
Command parameters are described in Table 1-33 
Table 1-33 
SET parameter descriptions 
Parameter Values Description 
clli Existing DAL, EANT,  CLLI to be activated (ON) or deactivared (OFF) 
or PRI CLLI in table 
TRKGRP. 
orig/term ORIG/TERM Specify NETSEC originations (ORIG) or NETSEC 


terminations (TERM) 


off/{0 to 255} OFF/{0 to 255} OFF - deactivate the specified NETSEC functionality 


{0 to 255} - activate the specified NETSEC 
functionality with the given index into table 
NETSPROF 


—end— 
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SET (continued) 


Example commands 
>NETSEC 
>SET DAL221TWDTLS ORIG 0 
>SET PRI922DRN2 ORIG 3 
>SET PRI922DRN2 ORIG 3 
>SET PRI922DRN2 TERM 9 
>SET DAL222TWDTLS ORIG OFF 
>SET DAL222TWDTLS ORIG OFF 
>SET DAL222TWDTLS TERM OFF 
>SET DAL111TWDTLS ORIG 2 
>SET AXEAN861C7LP01 TERM 0 


Responses 
The following are possible responses to the SET subcommand: 


NETSEC ORIG option is added to DAL221TWDTLS with NETSPROF 
index 0. 


Explanation: 
NETSEC ORIG/TERM is successfully activated on a DAL CLLI 
with the given NETSPROF index. 


User action: 
None. 


NETSEC ORIG option is added to PRI922DRN2 with NETSPROF index 
3. 


Explanation: 
NETSEC ORIG/TERM is successfully activated on a PRI CLLI with 
the given NETSPROF index. 


User action: 
None. 


WARNING: NETSEC ORIG option is already ON with NETSPROF index 
3. No change was made. 


Explanation: 
NETSEC ORIG/TERM option already exists in the activating CLLI 
and the given NETSPROF index is the same. 


User action: 
None. 
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SET (continued) 


NETSEC TERM option is added to PRI922DRN2 with NETSPROF index 


9 


Explanation: 
NETSEC TERM option is added to the CLLI with the given 
NETSPROF index. 


User action: 
None. 


NETSEC ORIG option is removed from DAL222TWDTLS. 


Explanation: 
NETSEC is successfully deactivated from a DAL CLLI. 


User action: 
None. 


WARNING: NETSEC ORIG option is already OFF. No change was 


made. 


Explanation: 
NETSEC ORIG option does not exist in the deactivating CLLI. 


User action: 
None. 


WARNING: NETSEC TERM option is already OFF. No change was 


made. 


DAL, 


Explanation: 
NETSEC TERM option does not exist in the deactivating CLLI. 


User action: 
None. 


ERROR: DAL111TWDTLS does not exist in table TRKGRP. 


Explanation: 
The CLLI to be activated does not exist in table TRKGRP. 


User action: 
Use a CLLI that already exists in table TRKGRP or set up the CLLI 
in table TRKGRP. 


ERROR: The NETSEC option can only be added/removed to/from 
EANT, PRI, and IMT trunks. 


Digital Switching Systems UCS DMS-250 Commands Reference Manual UCS17 


2-118 Commands 


NETSEC commands 


SET (continued) 


Explanation: 
The CLLI to be activated is not a DAL, EANT, PRI, or IMT trunk. 


User action: 
Use a DAL, EANT, PRI, or IMT CLLI. 


Error messages 


The following error messages can display as a result of the SET 
subcommand: 


ERROR: 


The NETSEC option can only be added/removed to/from 


DAL, EANT, PRI and IMT trunks 


ERROR: 


Explanation: 
The CLLI to be activated/deactivated is not a DAL, EANT, PRI, or 
IMT CLLI. 


User action: 
Enter a DAL, EANT, PRI, or IMT CLLI. 


<CLLI> does not exist in table TRKGRP 
Explanation: 
The user tried to enter a CLLI that does not exist in table TRKGRP. 


User action: 
Enter a CLLI that exists in table TRKGRP. 


Warning: NETSEC option is already ON with NETSPROF index 4. 
No change was made 


Explanation: 
The user tried to enter the NETSEC ORIG/TERM option that already 
exists in the activating CLLI, and the NETSPROF index is the same. 


User action: 
None. The NETSEC option already exists for that CLLI. 


Warning: NETSEC ORIG option is already OFF. No change was 


made. 


Explanation: 
The user tried to change the NETSEC ORIG/TERM option to OFF 
that already did not exist on the deactivating CLLI. 
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SET (end) 


User action: 
None. The NETSEC option is already removed from the CLLI. 


Related commands 
The following commands are accessed through the NETSEC directory: 
e LIST 
e LISTFRAUD 
e HELP 
e QUIT 
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Purpose 


The List (LIST) command displays one or all trunk groups (of the NETSEC 
CLLI type) that have the Network Security (NETSEC) function activated in 
table TRKGRP. 


Note: NETSEC CLLI type of trunk group refers to the only trunks 
supported by NETSEC functionality: Direct Access Line (DAL), Equal 
Access Network Trunk (EANT), Primary Rate Interface (PRI) and 
Inter-Machine Trunk (IMT). 


Note: EANT includes Signaling System 7 (SS7) or Per Trunk Signaling 
(PTS). IMT includes Signaling System 7 (SS7) Inter, Q.767 Global, 
Integrated Services User Part (ISUP) 92 Global, and Per Trunk Signaling 
(PTS). 


The LIST command can generate a NETSEC status report for a specific 
CLLI or for an entire trumk group type. The status reports show the CLLL, if 
NETSEC originations, terminations, or both are active, and the associated 


NETSPROF profile index. 
Access 

>NETSEC 
Syntax 

>LIST <c11i> | DAL | EANT | PRI | IMT | ALL 
Parameters 


Command parameters are described in Table 1-34 
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LIST (continued) 


Table 1-34 


LIST parameter descriptions 


Parameter 


Values Description 


clli 


DAL, EANT, PRI, DAL, EANT, PRI, or DAL, EANT, PRI, or IMT CLLIs 


IMT 
ALL 


Existing DAL, EANT, —CLLI to be listed 
PRI, or IMT CLLI 

name in table 

TRKGRP 


IMT 
ALL All DAL, EANT, PRI, and IMT CLLIs 


—end— 


Example command 


Responses 


>NETSEC 

>LIST DAL222TWDTLS 
>LIST DAL221TWDTLS 
>LIST DAL248TWDTLS 
>LIST DAL223TWDTLS 
>LIST DAL111TWDTLS 
>LIST DAL 

>LIST AXEAN674TWMFWK 


The following are possible responses to the preceding LIST commands: 


DAL222TWDTLS is ON (ORIG 4 ) 


Explanation: 
The NETSEC CLLI for this specific DAL is listed in table TRKGRP 
and the NETSEC ORIG option is present. 


User action: 
None 


DAL221TWDTLS is ON (ORIG 0 TERM 5 ) 


Explanation: 

The NETSEC CLLI for this specific DAL is listed in table TRKGRP 
and the NETSEC ORIG and the NETSEC TERM options are 
present. 
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User action: 
None 


DAL248TWDTLS is ON ( TERM 3 ) 


Explanation: 
The NETSEC CLLI for this specific DAL is listed in table TRKGRP 
and the NETSEC TERM option is present. 


User action: 
None 


DAL223TWDTLS is OFF 


Explanation: 
The NETSEC CLLI for this specific DAL is listed in table TRKGRP 
but the NETSEC option is not activated. 


User action: 
Activate this DAL CLLI by using the “SET <clli> ON” command or 
select another valid DAL trunk that has the NETSEC option ON. 


Error: Invalid CLLI or trunk group type (DAL111TWDTLS) 


Explanation: 
The CLLI for this specific DAL is not a NETSEC CLLI/trunk group 
type or does not exist. 


User action: 
Enter a CLLI that exists in table TRKGRP. 


NETSEC is ON for: 


DAL221TWDTLS (ORIG 0 TERM 5) 
DAL222TWDTLS (ORIG 4 ) 


Total tuple(s) found: 2 


Explanation: 
All of the listed DAL trunk group types have the NETSEC option 
activated. 


User action: 
None 
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LIST (end) 


ERROR: 


NETSEC only supports DAL, EANT, PRI, and IMT trunks 


Explanation: 
The CLLI listed exists in table TRKGRP but its trunk group type is 
not a DAL, EANT, PRI, or IMT. 


User action: 
Enter a DAL, EANT, PRI, or IMT CLLI. 


Error messages 


The following error messages can display as a result of the LIST 
subcommand: 


ERROR: 


Invalid CLLI or trunk group type (<name of trunk that 


user input>) 


ERROR: 


Explanation: 
The CLLI name/trunk group type listed is not a NETSEC CLLI/trunk 
group type or does not exist. 


User action: 
Enter a CLLI/trunk group type that exists in table TRKGRP. 


NETSEC only supports DAL, EANT, PRI, and IMT trunks 


Explanation: 
The CLLI listed exists in table TRKGRP but its trunk group type is 
not a DAL, EANT, PRI, or IMT. 


User action: 
Enter a DAL, EANT, PRI, or IMT CLLI. 


Related commands 
The following commands are accessible through the NETSEC directory: 


e SET 

e LISTFRAUD 
e HELP 

e QUIT 


Digital Switching Systems UCS DMS-250 Commands Reference Manual UCS17 


2-124 Commands 


NETSEC commands 
LISTFRAUD 


Purpose 


The List Fraud (LISTFRAUD) command is used to list all active calls that 
are possible fraud calls. Active calls are calls that have been answered but 
have not yet disconnected at the time the command is issued. Possible fraud 
calls are calls that have generated either a NETS601 log, NETS603 log, or a 
CDR at the time the call was answered. 


The LISTFRAUD command can be issued alone or with a parameter that 
specifies the number of calls to list. If the command is issued alone the user 
is shown the current active possible fraud call count and prompted to enter 
ALL or the number of calls to list. If the command is issued with a valid 
parameter the call count is shown and the list of calls and associated 
information is shown in a tabular format. 


Access 

>NETSEC 
Syntax 

>LISTFRAUD 
Parameters 

None 


Example command 
>NETSEC 
>LISTFRAUD 


Responses 
The following are example responses to the LISTFRAUD command: 


> NETSEC 
NETSEC: 


> LISTFRAUD 

Current possible fraud call count is 3. 

Next par is: <NUMBER or ALL> {0 TO 1000, 
ALL} 


Enter: <NUMBER or ALL> 
>1 
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LISTFRAUD (end) 

ORIG TERM CALL CALLING CALLED NET OP TP WZONE 
GRP# GRP# DUR NO NO SEC 


3122 3121 00:01:24 2146112211 2148201234 0 0 0 10 


> LISTFRAUD 
Current possible fraud call count is 3. 
Next par is: <NUMBER or ALL> {0 TO 1000, 


ALL} 
Enter: <NUMBER or ALL> 
>all 
ORIG TERM CALL CALLING CALLED NET OP TP WZONE 
GRP# GRP# DUR NO NO SEC 


3122 3121 00:03:59 2146112211 2148201234 O 0 0 6 
0228 0248 00:03:41 2142480000 T 0 2 10 
1623 0265 00:21:05 2146112211 82659003000265 B 5 3 0 


Related commands 
The following commands are accessible through the NETSEC directory: 


e SET 

e LIST 
e HELP 
e QUIT 
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HELP 
Purpose 
Use the Help (HELP) command to display text and information about the 
NETSEC commands. 
Access 
>NETSEC 
Syntax 
>HELP 
Parameters 
None 


Example command 


>NETSEC 
>HELP 
Responses 

The following are possible responses to the HELP command: 

>NETSEC 

NETSEC: 

>HELP 

LIST: Command to report the NETSEC status on a given 
CLLI, trunk group, or all NETSEC trunk groups 
and the associated NETSPROF indices. 

Syntax: LIST <clli> | DAL | EANT | PRI | IMT | ALL 

SET: Command to add/remove the NETSEC ORIG/TERM 
option and NETSPROF index to/from a CLLI. 

Syntax: SET <clli> <option> 

LISTFRAUD: Command to list all active calls that are 
possible fraud calls. 

Syntax: LISTFRAUD 

QUIT: Command to exit the NETSEC CI command. 

Syntax: QUIT 


Note: If you are in the NETSEC command and type NETSEC, the HELP 


response is displayed. 


>NETSEC 
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HELP (end) 


LIST: 


Syntax: 


SET: 


Syntax: 


LISTFRAUD: 


Syntax: 


QUIT: 
Syntax: 


Command to report the NETSEC status on a given 
CLLI, trunk group, or all NETSEC trunk groups 
and the associated NETSPROF indices. 

LIST <clli> | DAL | EANT | PRI | IMT | ALL 


Command to add/remove the NETSEC ORIG/TERM 
option and NETSPROF index to/from a CLLI. 
SET <clli> <option> 


Command to list all active calls that are 
possible fraud calls. 
LISTFRAUD 


Command to exit the NETSEC CI command. 
QUIT 


Explanation: 
This is the information menu that is displayed when using the HELP 
command. 


Related commands 


The following commands are accessible through the NETSEC directory: 


« SEP 
e LIST 


e LISTFRAUD 


e QUIT 
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QUIT (end) 


Purpose 


The Quit (QUIT) command exits the NETSEC directory and returns to the 
command interpreter (CI:) prompt. 


Access 

>NETSEC 
Syntax 

>QUIT 
Parameters 

None 


Example command 
>QUIT 


Responses 
The system returns to the CI: prompt. 


Related commands 
The following commands are accessible through the NETSEC directory: 
e SET 
e LIST 
e LISTFRAUD 
e HELP 
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PROGDIR (end) 


Purpose 
PROGDIR accesses the PROGDIR directory. 
Access 
>PROGDIR 
Syntax 
> 
Parameters 


Example command 


> 


Responses 


Related commands 
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CAINSCPT 


Purpose 
Use the CAINSCPT command to perform one of the following functions: 


e TRIDIDLE—idles the specified TRID(s) 


e TRIDINFO—displays information on the specified TRID(s). If the 
TRID(s) are idle, the UCS DMS-250 switch displays only information 
on those TRID(s). If the TRID(s) are in use, the switch prints the 
information on the TRID(s) as well as the associated information kept 
with the TRIDs. 


e TRIDUSE—activates specific TRIDs by placing them “in use.” Use this 
function for testing and debugging. TRIDUSE does not allow you to 
specify any other information associated with TRID(s). 


WARNING 

Do not alter TRID entry while call is in conversation. 
Calls will behave strangely if the TRID entry associated 
with the call is altered while the call is in conversation. 


Access 

>CAINSCPT 
Syntax 

>CAINSCPT FUNCTION TRIDS 
Parameters 


The command parameters are described in Table 1-35. 
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CAINSCPT (continued) 
Table 1-35 
CAINSCPT parameter descriptions 
Parameter Values Description 
function TRIDINFO Specifies which function of CAINSCPT 
you are performing. 
TRIDIDLE 
TRIDUSE 
TRIDs All Specifies the TRID on which you are 
performing the function. If the first 
TRID number, parameter to range is larger than the 
second, the switch reverses them. 
RANGE 
number Note: The range of numbers is limited by 
the maximum number of TRIDs available 
number to the simulator. Currently, that number is 


100. 


—end— 


Example commands 


The following are example CAINSCPT command entries. 


Example one 


This is an example of idling Transaction Identifiers (TRIDs) using the range 


specifier. 


>CAINSCPT TRIDIDLE range 5 10 


Clearing 
Clearing 
Clearing 
Clearing 
Clearing 
Clearing 


Example two 


HHHHARH 


RID 
RID 


RID 
RID 
RID 
RID 


H O OAD 


This is an example of displaying information about the TRIDs using just one 


TRID. 


>CAINSCPT TRIDINFO TRID 6 


TRID 6 IS IDLE 
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Example three 
This is an example of making all of the TRIDs in use using the ALL 
specifiers. 
>CAINSCPT TRIDUSE ALL 


Responses 


After the CAINSCPT command successfully completes, the system displays 
one of the following responses. 


Clearing TRID <num> 
Explanation: 
Occurs when you enter a TRIDIDLE function on a single TRID. 


System action: 
None 


User action: 
The switch sets the TRID that was specified on the command line to 
the idle state. 


Invalid TRID No. <num> 


Explanation: 
Occurs when you try to perform a function on a TRID number that is 
out of range 


System action: 
None 


User action: 
None 


TRID <num> is already in an idle state 


Explanation: 
Occurs when you try to IDLE a TRID that is already in idle state. 


System action: 
None 


User action: 
None 


TRID <num> is already in use 
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Explanation: 
Occurs when you use the TRIDUSE function, placing a TRID in use 
that is already in use. 


TRID<num> is idle 


Explanation: 
Occurs when you enter a TRIDINFO function on a single TRID that 
is idle. 

TRID <num> IS IN USE 

INVOKE ID: <num> 


CAINMTCH IDX: OUT OF RANGE 
PLAYLIST IDX: <NUM> 


DIGITS [0]: NONE 
DIGITS [1]: NONE 
DIGITS [2]: NONE 
DIGITS [3]: NONE 


Explanation: 
Occurs when you enter a TRIDINFO function on a TRID that is in 
use. 


TRID <num> was put in use by another process 


Explanation: 

Occurs when you use the TRIDUSE command. When the command 
began to execute, the TRID was idle. However, when the code tried 
to find the idle TRID, it was unavailable. 


Related commands 
Commands related to CAINSCPT include: 


e SCP Simulator 
e CAINTEST 
e VPTRACE 


Digital Switching Systems UCS DMS-250 Commands Reference Manual UCS17 


2-134 Commands 


QANIDIR directory 
QANIDIR (end) 


Purpose 
QANIDIR accesses the QANIDIR directory. 
Access 
>QANIDIR 
Syntax 
Parameters 


Example command 


Responses 


Related commands 
The following commands are accessible through the QANIDIR interface: 


e COPY 

e COUNT 
e DISPLAY 
e DUMP 

© FIND 

© HELP 

e LIST 

* DELETE 
e RENAME 
e QUIT 

© QANI 
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Purpose 


The SOC command accesses the SOC directory. 


Software Optionality Control (SOC) is the tool for managing software 
options. When an operating company purchases an option, SOC allows the 
company to monitor and control its use. Options can be ordered, activated, 
and used without a software reload or restart. 


Capabilities 
SOC provides the following capabilities: 


provides an interface through which you can disable and enable SOC 
options 


ensures no option is activated unless it is safe to do so 
tracks the state (on or idle) of SOC options 
generates reports with status information about SOC options 


provides a way to count and limit the usage of DMS services and 
resources 


defines and tracks options not controlled by SOC 


Phases of operation 
SOC has three phases of operation: 


software application—the software product computing module load 
(PCL) is installed on the DMS-250 switch. After an installation, all SOC 
options remain in their specified states (on or idle) until a state change is 
requested through the SOC user interface. 


restarts—during warm and cold restarts, SOC retains its database 
information. 


normal operation—SOC periodically audits options during normal 
operation. 


Right to use 


When an operating company purchases a software option, Northern Telecom 
gives the company a password called a “key code” for the option. This key 
code gives operating company personnel permission to change the state of 
the option to on or idle (or, in other words, the right to use the option). 
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Option types 
There are three types of SOC options: 


state option—has a right-to-use (RTU) setting of yes or no and a state 
setting of on or idle. The RTU setting allows you to change the state of 
an option and must be set to yes before you can do so. 


usage option—has usage limits of hard, soft, or monitored and a current 


usage 


combo option—has both a usage limit and an on or idle state 


Functionality 


The SOC commands allow you to enable and disable SOC options, audit the 


SOC database, generate reports on SOC options, and reset usage of options. 


For more information on SOC, see the DMS-100 Family Software 
Optionality Control User’s Manual. 


The SELECT command displays reports about the options defined in a 


product computing load (PCL). There are several report types. The displayed 


data may be selected in several different ways. 


Specifying options 
Reports displayed includes a set of options or a single option. You may 
specify any of the following: 


a particular option by order code or name 

all options with the order code or name containing a given substring 
all options in a give group 

all state-based options, including combos 

all options in a given state (IDLE, ON, or ERR), including combos 


all options with the right-to-use (RTU) flag in either the YES or NO 
setting (including usage options with non-zero or zero limits) 


all usage-based options, including combos 
all options with current usage over the warning threshold 
all options with current usage of zero and of non-zero 


all options 
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Report types 
There are four report types: 


BRIEF (default)—contains one line per option with the following 
information: 


— order code 
— name 
— right-to-use status 
— state 
— current usage 
— usage limit 
— units of usage counting 
— date of last change (RTU or usage limit) 
— flag indicator 
— tracked option (TRAK) 
— a pending option (PEND) 


— ausage option with current usage over the warning threshold 
(>THR), over the limit (>LIM), or over the maximum that SOC 
can record (>~MAX) 


— a Status indicator of in service, troubled (ISTB) or error condition 
(ERR) 


VERBOSE—contains all the information of the BRIEF (default) report; 
also adds one or more lines for each option. These lines indicate 


— for a state option, the dependencies of the option (what other options 
it requires or cannot co-exist with in the ON state) 


— for a usage option, the warning threshold and high water mark 


— for a combo option, both the dependencies of the option and the 
warning threshold and high water mark 


FULL—contains all the information of a VERBOSE report; adds 
information on the member features of each option. For each feature, the 
report includes 


— ID code 
— name 


— feature state (if applicable) 
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Access 


Responses 


— feature dependencies (if applicable) 

— feature error status 

Features are listed directly under their owner options. The FULL report 
format is only available from the SOCDEBUGDIR CI increment. 


PACK—a compressed report format and the format in which Northern 
Telecom expects to receive its regular status reports. This report includes 
the following: 


— for each state option 
— order code 
— RTU indicator 
— current state 
— date of the last RTU change 
— for each usage and combo option 
— order code 
— current usage 
— usage limit 
— high water mark 
— date of last limit change 
— Pending or tracked option records are flagged “PEND” or “TRAR”. 


— Includes a checksum at the end of the report. This allows you to 
verify the report. 


— PACK reports are 


— written to a file named “<CLLI>$SSR”. <CLLI> is obtained 
from the OFFICE_CLLI_NAME in table OFCENG 


— written to the device indicated by table SOCVAR 
— PACK reports are available only with the SELECT ALL command. 


The SOC commands allow you to enable and disable SOC options, audit the 
SOC database, generate reports on SOC options, and reset usage of options. 
The following responses may display as a result of the SOC command. 
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User count exceeded; SOC in use by <userid> 


Explanation: 


Occurs if SOC is already in use. Only one SOC session is allowed at 


a time. 


System action: 
Does not start SOC. 


User action: 


If you are sure that SOC is not running, you can reset the usage 
counter using the TOOLSUP tool manager. Type TOOLSUP at the 


CI, and then RESET SOC. 


Soc is already running 
Explanation: 
Occurs if the CI session already has SOC running. 


System action: 
Does not start SOC. 


User action: 
None 


Couldn’t allocate SOC command directory...SOC not started 


Explanation: 


Occurs if SOC has a resource problem with the office, and it cannot 


allocate its directories. 


System action: 
Does not start SOC. 


User action: 
None 


Couldn’t allocate mailboxes...SOC not started 


Explanation: 
Occurs if SOC cannot allocate its mailboxes. 


System action: 
Does not start SOC. 
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SOC (end) 


User action: 
None 


Related commands 
The following commands are available in the SOC directory: 


e ASSIGN 

e DBAUDIT 

e REMOVE 

e RESET 

e RESET_AUDIT 
e SELECT 
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Purpose 
The ASSIGN command allows you to control software options as follows: 
e enable an option through right-to-use 
e assign a usage limit to an option 
e change the state of an option (such as from IDLE to ON) 
e assign a warning threshold to an option 
If you assign the state of an option to IDLE from ON, loss of the service 
provided by the option results. SOC warns you if the option is still in use 
(meaning still datafilled on some lines) and gives you the opportunity to 
confirm the change to IDLE. 
Access 
Syntax 
>ASSIGN RTU keycode TO order code 
>ASSIGN RTU FROM FILE filename device 
>ASSIGN STATE state TO order code 
>ASSIGN LIMIT limit password/keycode TO order code 
>ASSIGN THRESHOLD threshold thresh_type to order code 
>ASSIGN RTU FROM FILE 
Parameters 
The command parameters are described in Table 1-36. 
Table 1-36 
ASSIGN parameter descriptions 
Parameter Values Description 
STATE n/a A request to change the state of the option 
RTU n/a Right to use; a request to grant the operating 
company the right to use the named option 
FILE n/a Indicates RTU passwords/keycodes are to be read 


from a file with the default file name <CLLI>$SCF 
and a default device (listed in table PADNDEV). 


—continued— 
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ASSIGN (continued) 


Table 1-36 
ASSIGN parameter descriptions (continued) 
Parameter Values Description 
KEYS n/a A request to read RTU granting, RTU removal, 
and/or limit keycodes (also called “passwords”) from 
a file 
THRESHOLD Three-digit percent A request to change the threshold of an option; 
or six-digit absolute threshold is used to indicate when logs should be 
number generated for an option that is approaching its usage 
limit 
LIMIT Alphanumeric 0 to This parameter sets the usage value. 
999999 
Alphanumeric 0 to S indicates that this is a soft limit. 
999999 with S 
appended 
MONITORED MONITORED indicates that there is no usage limit, 
but usage is still tracked. 
state String: Enter the state to set the option to; possible values 
are as follows: 
IDLE Indicates the option is present but nonfunctional 
(may be datafilled) 
ON Indicates the option functions normally 
order code Alphanumeric Enter the order code that identifies the option (order 
(8 characters) code is defined by Northern Telecom). 
keycode Alphanumeric Enter the keycode (also called “password”) (supplied 
(20 characters) by Northern Telecom); this gives the user permission 
to use and change the state of an option. 
filename Alphanumeric The name of a file (Supplied by Northern Telecom) 
that contains order codes and keycodes. SOC will 
read the file and apply the keycode to its 
corresponding order code. 
device Alphanumeric Device on which to look for the named file; SOC uses 
table PADNDEV to find default volumes if the device 
is not supplied. 
—continued— 
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Table 1-36 
ASSIGN parameter descriptions (continued) 
Parameter Values Description 
threshold Numeric; 3 digit The value of the threshold 


percent or 6 digit 
absolute number 


thresh_type PERCENT or The type of threshold being given; default is 
ABSOLUTE ABSOLUTE 
—end— 


Example command 
>ASSIGN STATE IDLE TO CAIN0802 


TAKEBACK & AND T 


THIS OPTION 


DONE. 


ENTERING THE 


RANSFER CAPABILITIES WILL NOT B 
IS SET TO IDLE. 
CONFIRM STATE CHANGE OF OPTION CAINO802 TO STATE 
TEXTUAL OPTION NAME: 


>ASSIGN STATE ON TO CAIN0802 


>ASSIGN RTU ABC123 TO CAINO802 


INCORR 


ECT K 


EY CODE 


FOR OPTION 


E AVAILA 


BLE IF 


IDLE 


BY 
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Responses 


After the ASSIGN command successfully completes, the system displays the 
following responses. 


<impact_stmt> Confirm state change of option <order code> to 
state <state> by entering the textual option name: 


Explanation: 

The system may display some messages to the user before asking for 
this confirmation; these messages relate to the impact or 
consequences of this action (such as loss of service of an option). 


User action: 

Type the textual option name (followed by the return key). If the 
name is typed correctly, SOC proceeds with the command. If you 
type nothing and press the return key, SOC aborts the command. If 
typed incorrectly, SOC gives you another chance to type the text 
name. You get three chances. After the third chance, the command is 
aborted and the event (three failed attempts) is logged. A SOC501 
log is generated. See Table 1-37 for feature names and order codes. 


Confirm state change of option CAINO802 to state IDLE by 
entering the textual option name: 


Explanation: 

This warning message displays when you attempt to change the state 
of the CAIN Takeback & Transfer SOC option (CAIN0802) from on 
to idle. 


System action 
The system waits for the user to type the name of the option. 


User action: 

Type the textual option name, “CAIN Takeback & Transfer’, 
followed by the return key. If the name is typed correctly, SOC 
proceeds with the command. If you type nothing and press the return 
key, SOC aborts the command. If typed incorrectly, SOC gives you 
another chance to type the text name. You get three chances. After 
the third chance the command is aborted and the event (three failed 
attempts) is logged. A SOCSO1 log is generated. See Table 1-37 for 
feature names and order codes. 


Done 
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Explanation: 

The ASSIGN command was completed correctly. If this was a state 
change, the option changed state successfully. If this was a 
right-to-use application, it was processed and accepted. If this was a 
read from a file of right-to-use passwords, all passwords were 
applied successfully and the file was deleted. 


Ghost option <order code> created [in <file> at line <line>] 


Explanation: 

An ASSIGN RTU command was entered for an unknown order code 
but with a correct password for the order code. SOC assumes this is a 
new “ghost” option (an option with no features but whose 
right-to-use can be enabled and whose state can be set). 


User action: 
The system creates the ghost option and sets its right-to-use flag to 
true. 


Error messages 


The following error messages may display as a result of the ASSIGN 
command. 


Attempt to revoke right-to-use (refused) in <filename> at 
line <linenum> 


Explanation: 

SOC was processing a right-to-use password file and encountered a 
“—” tag in the first column (indicates an attempt to revoke a 
right-to-use). 


User action: 

Skip this line and continue processing the remainder of the file. The 
file is not deleted when processing is complete. If it was meant to be 
an attempt to grant the right-to-use, put a “+” where the “—” is and 
try again. 


Cannot find file <filename> on device <device> 


Explanation: 

The user tried to read a file of right-to-use passwords, but the file 
was not found. This message generates if the user supplies a file 
name that does not exist or if the default file name incorrect. 
<Device> is the device that was searched. 
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System action: 
The system aborts the command. 


User action: 
Ensure the file is correctly named and on the appropriate volume. 
SOC searches volumes listed in PADNDEV and SFDEV by default. 


Cannot find file <filename> on any device in table PADNDEV. 


Done. 


Explanation: 

The user tried to read a file of right-to-use passwords, but the file 
was not found. This message generates if the user supplies a file 
name that does not exist or if the default file name is incorrect. If the 
device is given as ALL (either from the command line or from the 
default in table SOCVAR), all devices listed in table PADNDEV are 
searched. If the file is not found on any of them, this message 
generates. 


System action: 
The system aborts the command. 


User action: 
Ensure the file is correctly named and on the appropriate volume. 
SOC searches volumes listed in PADNDEV and SFDEV by default. 


<N> errors detected. File not erased. 


Explanation: 

SOC was processing a right-to-use password file and encountered 
errors. This summary line generates when SOC has processed the 
file. SOC does not erase the file. 


User action: 

Check the file for obvious errors (based on the messages SOC 
produced while processing the file). If the fix is not obvious, contact 
Northern Telecom. 


Illegal order code <code> [in <file> at line <line>] 


Explanation: 

The order code is not a legal order code that is 8 alphanumeric 
characters. <Code> is the order code typed by the user or read from 
the file. If read from a file, the file name and line number are given 
as well. 
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System action: 
The system aborts the command. 


User action: 
Check the order code for validity. Retry if it was a typographical 
error. Otherwise, check with Northern Telecom. 


Incorrect CLLI in <filename> at line 1 


Explanation: 

SOC tried to read a file of right-to-use passwords and found the 
CLLI on the first line of the file does not match the CLLI for this 
office (as recorded in the OFCENG table). 


System action: 
The system halts processing but does not delete the file. 


User action: 

Obtain a corrected password file from Northern Telecom or check 
with Northern Telecom for the CLLI for the user office. It is not 
usually sufficient to edit the file and insert the CLLI for the office. 
The passwords in the file have the CLLI that was at the beginning of 
the file encoded in them; they will all fail if applied to an office with 
a different CLLI. 


Incorrect password/keycode for option <order code> [in <file> 
at line <line>] [but right-to-use was already set, so state 
changes are allowed] 


Explanation: 

The user tried to apply a right-to-use password (also called 
“keycode’’) to an option, but the password was incorrect. <Order 
code> is the order code typed by the user. If the option and password 
were read from a file, the <file> and <line> are given. If the 
right-to-use was already set, the “but right to use...” clause displays. 


User action: 

Ensure the password and order code were correctly typed if this was 
entered from the command line. If so, contact Northern Telecom for 
the correct password. Ensure the CLLI for this office agrees with 
Northern Telecom information. If the option and password were read 
from a file, obtain a corrected file from Northern Telecom. 


Right-To-Use not granted 
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Explanation: 
The named option is not permitted to change state because the 
enabling password has not been applied. 


System action: 
The system does not perform the command. 


User action: 
Contact Northern Telecom to buy this option and a password will be 
provided. 


Syntax error [in <file> at line <line>] [<command_syntax>] 


Explanation: 

SOC was unable to make sense of the command. If the command 
was read from a file, it gives the file name and line number. If not 
from a file, the command syntax displays. 


System action: 
The system aborts the command. 


User action: 
Retry the command with the appropriate syntax. 


Unknown grant/revoke tag in <filename> at line <linenum> 


Explanation: 
SOC was processing a file of right-to-use passwords and found an 
entry with an incorrect grant/revoke tag. 


System action: 

The system continues processing subsequent entries in the file. It 
does not alter the right-to-use status of the order code with the 
incorrect tag. The file is not deleted when processing is complete. 


User action: 
Obtain a corrected file from Northern Telecom or edit the file. 


Unknown order code <code> [in <file> at line <line>] 


Explanation: 

SOC has no record of the named option. The <code> is the order 
code typed by the user or read from the file. If it is read from a file, 
the file name and line number are given as well. 
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System action: 
The system aborts the command. 


User action: 
Check the order code for validity. Retry if it was a typographical 
error. Otherwise, check with Northern Telecom. 


<Failure reasons> Transition failed. Option is in state 
<state>. 


Explanation: 

User tried to change the state of the option, but an error occurred 
during the attempt. The current state may be the state the option 

started in or a transient state between the initial and target states. 


User action: 
Correct the problem and try the command again. 


<Validation errors> Transition refused, because of validation 
errors 


Explanation: 

SOC did not perform the requested state transition because all or part 
of the option would fail to change state successfully. Validation 
errors display as a brief summary of what is wrong and how to fix it. 


User action: 
The system aborts the command. Make the appropriate changes and 
retry. 


<Description of dependency errors> Transition refused due to 
database inconsistencies. 


Explanation: 

The system found one or more database inconsistencies (such as a 
cycle in the dependency structure). This made it impossible to check 
the dependencies before changing the option’s state. SOC does not 
allow the state change until the dependencies can be checked. 


User action: 
The system aborts the command. 


<Description of dependency errors> Transition refused due to 
dependency errors. 
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Explanation: 

SOC refuses to perform the state transition because needed options 
are not turned on, mutually exclusive options are turned on, or 
options which use this one are still on (if turning the option IDLE). 


User action: 
The system aborts the command. 


SOC feature order codes used with ASSIGN 


Table 1-37 lists several SOC feature order codes used with the ASSIGN 
command. Order codes are 8-character option order numbers. These codes 
uniquely identify a set of feature functionality on the UCS DMS-250 switch. 


For a complete list of SOC order numbers, refer to the table, List of UCS 
DMS-250 SOCsin the UCS DMS-250 Software Optionality Control User’s 
Manual. 


Table 1-37 
ASSIGN SOC feature names and order numbers 


SOC feature Order number 


ISDN PRI RLT (release link trunk capability for PRLT0001 


PRI trunks) 

UCS Translations and Routing Services (CIC UTRSOO01 
routing) 

NOOR NOO/NXX TCAP Services (NOO/NXX NOOROO002 


TCAP number translation services and 
automatic code gapping) 


Calling Card Services (basic UCS DMS-250 CRDSO0001 
calling card; travel card number log 
enhancement; enhanced calling card) 


TCAP Based Card Services (TCAP-based CRDS0002 
services; travel card number verification using 
Cl command TESTSS ACCTTEST) 


Network Services NSEROO01 

TCAP Auth & Acctcode Val NSEROO002 

Inter/Intra IMT NSER0O003 
—continued— 
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Table 1-37 


ASSIGN SOC feature names and order numbers (continued) 


SOC feature Order number 
Super GD Control NSERO004 
NPRI PRI Network Interface (access transport NPRIOOO1 
PRI/SS7 functionality; PRI D-channel backup 

functionality) 

ENSR Enhanced Network Services (EOPS ENSR0001 
reorigination; single and multiple release link 

trunk) 

ENSR Enhanced Reorigination ENSR0002 
ENSR Nonzero RLT ENSR0003 
Dialable Wideband Services UDWS0001 
CAIN Messages CAIN0100 
CAIN Extension Parms CAIN0200 
CAIN SCP Simulator CAIN0300 
CAIN Test Query Tool CAIN0400 
CAIN CUSTDP Trigger CAIN0500 
CAIN SPECDIG Trigger CAIN0501 
CAIN OFFHKIM Trigger CAIN0502 
CAIN SIOTRK Trigger CAIN0503 
CAIN PRIBCHNL Trigger CAIN0504 
CAIN ONOANSWER Trigger CAIN0505 
CAIN NETBUSY Trigger CAIN0506 
CAIN OCLDBUSY Trigger CAIN0507 
CAIN OFTRREQ Trigger CAIN0508 
CAIN OIECREO Trigger CAINO509 
CAIN TERMATT Trigger CAIN0510 
CAIN SPECFEAT Trigger CAINO511 
CAIN OFFHKDEL Trigger CAIN0512 


—continued— 
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ASSIGN (end) 


Table 1-37 
ASSIGN SOC feature names and order numbers (continued) 


SOC feature 


Order number 


CAIN TOLLFREE Trigger 
CAIN Con Digit Collect 
CAIN SCP Trigger Sub 
CAIN EDPs 

CAIN STR Connection 
CAIN Inter IMT Support 
CAIN Global IMT Support 
CAIN 1129-Style IP 

CAIN Virtual IP 

CAIN Termination Notification 
CAINPRT Digit Coll 

CAIN LNP QOO 

CAIN Mid-Call Services 1 
CAIN Mid-Call Services 2 
CAIN Takeback & Transfer 
CAIN Auto Code Gapping 
CAIN Manual Code Gapping 


CAIN0513 
CAINO600 
CAINO601 
CAIN0602 
CAIN0603 
CAIN0604 
CAINO605 
CAINO606 
CAIN0607 
CAINO609 
CAIN0610 
CAIN0700 
CAINO800 
CAINO0801 
CAIN0802 
CAINO900 
CAINO901 


—end— 


Related commands 
The following commands are related: 


DBAUDIT 
REMOVE 
RESET 
RESET_AUDIT 
SELECT 
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Purpose 


Access 
Syntax 


Parameters 


The DataBase Audit (DBAUDIT) command allows you to perform an audit 
of the software optionality control (SOC) database. SOC regularly and 
automatically audits its database. The audit requested by the DBAUDIT 
command provides you with the information at the MAP terminal in 
addition to the logs generated by the audit. 


This command reports on any internal inconsistencies in the SOC data 
structures and on any discrepancies between the SOC’s settings of features 
and the features’ settings. 


>DBAUDIT 


None 


Example command 


Responses 


>DBAUDIT 


The following is an example of a response to a DBAUDIT command with 
the system corrupted. 


>DBAUDIT 

OPTION CAINO802: INVALID FEATURE LIST 

OPTION CAINO802: CLEARING TROUBLE FLAG 

OPTION CAINO802: IN TRANSIENT STATE IDLE TO ON 
3 ERRORS DETECTED CONTACT NT SUPPORT. 


The following are possible responses to the DBAUDIT command. 


SOC audit completed. No errors found. 


Explanation: 
The audit completed and found no errors. 


Error messages 


The following error messages may display as a result of the DBAUDIT 
command. 
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<Trouble details> SOC audit completed. <N> errors found. 
Explanation: 
SOC found one or more problems in its database. 


For more detailed information about the audit of the database, refer to the 
UCS DMS-250 Software Optionality Control User’s Manual. 


Related commands 
The following commands are related: 


e ASSIGN 

e REMOVE 

e RESET 

e RESET_AUDIT 
e SELECT 
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Purpose 
The Delete (DELETE) command removes an option or feature from the 
SOC database. 
Access 
Syntax 
>DELETE <Type> <Object> [<NoPrompt>] 
Parameters 
The command parameters are described in Table 1-38. 
Table 1-38 
DELETE Command Parameters 
Parameter Values Description 
<Type> Character string as indicates how to select the option or feature to 
follows: delete. 
OPTION and indicate that <Object> is an order code 
OPT 
FEATURE and indicate that <Object> is a feature 
FTR 
<Object> Alphanumeric string 
as follows: 


Up to 8 characters. Character order code. For OPTION or OPT, value 
should be an 8-character order code (for example, 
CAINO607). 


Up to 25 characters Character option group plus option name. For 
FEATURE or FTR, a value should be a 25-character 
(max) option name (including group code, for 
example “CAIN SPECFEAT” or AX018801). 


—continued— 
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Table 1-38 
DELETE Command Parameters (continued) 
Parameter Values Description 
<NoPrompt> NOPROMPT This parameter indicates that no confirmation prompt 


is given to the user before the object is deleted from 
the SOC database. 


—end— 


Example command 
>DELETE OPTION CAIN0607 
TO BE DETERMINED. 


Responses 
See the Example command section. 


Related commands 
The following commands are related: 


e ASSIGN 

e DBAUDIT 

e REMOVE 

e RESET 

e RESET_AUDIT 
e SELECT 

e VALIDATE 
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Purpose 
The Remove (REMOVE) command allows you to remove the right to use 
the option. After the right to use is removed, the option is not allowed to 
change state from On to Idle. 
This command applies only to state options. Usage options are controlled by 
setting the usage limit. 
Access 
Syntax 
>REMOVE RTU keycode FROM order code 
Parameters 
The command parameters are described in Table 1-39. 
Table 1-39 
REMOVE parameter descriptions 
Parameter Values Description 
RTU n/a Right to use; a request to grant the operating 
company the right to use the named option 
Key code 20 alphanumeric A keycode (or password) generated by Northern 
characters Telecom to permit the removal of an option’s right to 
use 
Order code 8 alphanumeric The Northern Telecom-defined order code for the 
characters option to be removed (for example, CAINO509 or 


CAIN0510) 


—end— 


Example command 


The following are examples of the REMOVE command. 


CAINO802 is IDLE 


>REMOVE RTU <correct_removal_RTU> FROM CAIN0802 


DONE 
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CAINO0802 is ON 
>REMOVE RTU <correct_removal_RTU> FROM CAIN0802 
CANNOT REVOKE RTU WHEN STATE IS NOT IDLE 


CAINO0802 is ON 
>REMOVE RTU abc FROM CAINO802 
INCORRECT KEYCODE FOR OPTION 


Responses 


The following are possible responses to the REMOVE command. 


Done. 


Explanation: 
The right to use is successfully removed. 


Error messages 


The following error messages may display as a result of the REMOVE 
command. 


Incorrect key code for removal of RTU from option. 


Not a 


Explanation: 
The keycode (also called password) is incorrect. The command is 
aborted. 


User action: 
Verify the password and try again. If necessary, contact Northern 
Telecom for the correct password. 


state based option. 


Explanation: 
User tried to remove the RTU of a usage or combo option. The 
command is aborted. 


User action: 
Control the option with the ASSIGN LIMIT command. To achieve 
an RTU of NO, set the LIMIT to 0. 


RTU cannot be removed because option is not idle. 


Explanation: 

The option is in state ON. The request is refused and the command 
aborted because an option cannot have an ON state with an RTU of 
NO. 
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User action: 
Set the state of the option to IDLE and try the command again. 
Unknown order code. 


Explanation: 
SOC does not recognize the order code supplied and aborts the 
command. 


User action: 
Verify the order code and try the command again. 


Related commands 
The following commands are related: 


e ASSIGN 

e DBAUDIT 

e RESET 

e RESET_AUDIT 
e SELECT 
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RESET 

Purpose 
The Reset (RESET) command allows you to reset the high water mark for a 
usage-controlled option. You may reset it to the current usage or to a given 
number. 

Access 
> 

Syntax 
>RESET HIGHWATER FOR order code TO high water 

Parameters 
The command parameters are described in Table 1-40. 

Table 1-40 


RESET parameter descriptions 


Parameter Values Description 

Order code 8 alphanumeric Identifies the usage-controlled option 
characters 

High water 6 digits; 0-999999 If present, indicates the value for the high water 


mark; default is current usage 


—end— 


Example command 
>RESET HIGHWATER FOR OSDA0006 TO TEXAS 


ILLEGAL HIGH WATER MARK; MUST BE A NUMBER IN THE RANGE 0 TO 
2°32-1.. 


Responses 
The following are possible responses to the RESET command. 


Done. 
Explanation: 


The highwater mark is changed for this option. 


Error messages 


The following error messages may display as a result of the RESET 
command. 
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illegal high water mark; must be a number in the range 0 to 
2^32=1. 


Explanation: 
The high water mark must be a number between 0 and 2^23-1. 


User action: 
Verify the correct range and try the command again. 


Illegal order code. 
Explanation: 
The order code is not syntactically legal. 


User action: 
Verify the order code and try the command again. 


Unknown order code. 
Explanation: 
The order code is not in the SOC database. 


User action: 
Verify the order code and try the command again. 


Related commands 
The following commands are related: 


e ASSIGN 

e DBAUDIT 

e REMOVE 

e RESET_AUDIT 
« SELECT 
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Purpose 
The Reset Audit (RESET_AUDIT) command allows you to reset the 
periodic audit. The audit will stop running if it fails three times in 
succession. After fixing whatever prevented the audit from performing, the 
audit can be restarted with this command. 
This command does not perform an audit. It stops the timer that triggers the 
next periodic audit, if there is one, and restarts it for the appropriate time 
from table SOCVAR. 

Access 
> 

Syntax 
> 

Parameters 


Example command 


> 


Responses 
The following response may display as a result of the HELP command. 
SOC periodic audit rescheduled; next audit at <date and time> 
Explanation: 


The audit is rescheduled for the date and time specified. 


Related commands 
The following commands are related: 


e ASSIGN 

e DBAUDIT 
e REMOVE 
e RESET 

« SELECT 
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Purpose 


The Select (SELECT) command displays reports about the options defined 
in a product computing load (PCL). There are several report types. The 
displayed data may be selected in several different ways. 


Specifying options 
Reports displayed includes a set of options or a single option. You may 
specify any of the following: 


a particular option by order code or name 

all options with the order code or name containing a given substring 

all options in a given group 

all state-based options, including combinations 

all options in a given state (IDLE, ON, or ERR), including combinations 


all options with the right-to-use (RTU) flag in either the YES or NO 
setting (including usage options with non-zero or zero limits) 


all usage-based options, including combinations 
all options with current usage over the warning threshold 
all options with current usage of zero and of non-zero 


all options 


Report types 
There are four report types: 


BRIEF (default)—contains one line per option with the following 
information: 


— order code 

— name 

— right-to-use status 

— state 

— current usage 

— usage limit 

— units of usage counting 

— date of last change (RTU or usage limit) 


— flag indicator 
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— tracked option (TRAK) 
— apending option (PEND) 


— ausage option with current usage over the warning threshold 
(>THR), over the limit (>LIM), or over the maximum that SOC 
can record (>~MAX) 


— a status indicator of in service, troubled (ISTB) or error condition 
(ERR) 


VERBOSE—contains all the information of the BRIEF (default) report; 
also adds one or more lines for each option. These lines indicate 


— for a state option, the dependencies of the option (what other options 
it requires or cannot co-exist with in the ON state) 


— for a usage option, the warning threshold and high water mark 


— for acombo option, both the dependencies of the option and the 
warning threshold and high water mark 


FULL—contains all the information of a VERBOSE report; adds 
information on the member features of each option. For each feature, the 
report includes 


— ID code 

— name 

— feature state (if applicable) 

— feature dependencies (if applicable) 

— feature error status 

Features are listed directly under their owner options. The FULL report 
format is only available from the SOCDEBUGDIR CI increment. 


PACK—a compressed report format and the format in which Northern 
Telecom expects to receive its regular status reports. This report includes 
the following: 


— for each state option 
— order code 
— RTU indicator 
— current state 
— date of the last RTU change 


— for each usage and combination option 
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— order code 
— current usage 
— usage limit 
— high water mark 
— date of last limit change 
— Pending or tracked option records are flagged “PEND” or “TRAK.” 


— Includes a checksum at the end of the report. This allows you to 
verify the report. 


— PACK reports are 


— written to a file named “<CLLI>$SSR.” <CLLI> is obtained 
from the OFFICE_CLLI_NAME in table OFCENG 


— written to the device indicated by table SOCVAR 
— PACK reports are available only with the SELECT ALL command. 


Access 
Syntax 
>SELECT select_type value report_type 
>SELECT ALL report_type 
Parameters 


The command parameters are described in Table 1-41. 


Table 1-41 
SELECT parameter descriptions 


Parameter Values Description 

Select_type Character Indicates how to select the option or set of 
string as options to display. 
follows: 
OPTION An order code interpreted as a substring. 


All order codes containing the substring 
are selected. 


—continued— 
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Table 1-41 
SELECT parameter descriptions (continued) 
Parameter Values Description 
NAME Indicates that <value> is the text name of 
an option. The text name of an option; 
must be surrounded by single quotes. 
STATE Selects all options whose current state is 
<value> (ON, IDLE or ERR). Also accepts 
STATE ALL to select all options. 
RTU Selects all options with the right-to-use 
granted. 
USAGE Selects all options with usage 
characteristics of one of the following: 
e ALL—all usage based options, 
including combinations 
e NONZERO—current usage is not zero 
e ZERO—current usage is zero 
e OVER_THRESHOLD—current usage 
exceeds usage warning threshold 
GROUP Selects all members of the named group. 
Value Alphanumeric 
OPTION Up to 8 Character order code. For <select_type> 
characters. of OPTION, <value> should be an 
8-character order code (for example, 
CAINO511). 
NAME Up to 25 Character option group plus option name. 
characters A 25 character (max) option name 
(including group code, for example “CAIN 
SPECFEAT”). 
STATE ALL, ON , State indicator; either On, IDLE or ERR 
IDLE, or ERR (includes transient states and options 
marked in TROUBLE in ERR). 
—continued— 
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Table 1-41 


SELECT parameter descriptions (continued) 


Parameter Values Description 
RTU YES, Y; or NO, Right-to-use indicator; either T, TRUE, F 
N or FALSE (T=TRUE=right-to-use is 
granted, F=FALSE=right-to-use is not 
granted). 
USAGE ALL, Usage indicator 
NONZERO, 
ZERO, or 
OVER_ 
THRESHOLD 
GROUP 3 or4 Option group 
characters 
report type This parameter indicates what type of 
report to generate for the selected 
options. 
BRIEF Default report type if no report type is 
given 
VERBOSE Brief report plus information on 
dependencies for options 
PACK A compressed report for transmission to 
Northern Telecom. 
FULL A verbose report plus a list of features 


associated with each option (and some 
information for each feature). This report 
is not available to customers as it is only 
available in SOCDEBUG. 


—end— 
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Example commands 
>SELECT OPTION CAIN0802 
>SELECT NAME ‘CAIN TAKEBACK & TRANSFER’ 
>SELECT GROUP ‘NSER’ 
>SELECT OPTION CAINO801 
>SELECT NAME ‘CAIN MIDCALL SERVICES 2’ 
>SELECT NAME ‘MIDCALL SERVICES 2’ 
>SELECT OPTION CAIN0510 
>SELECT OPTION ‘CAIN TERMATT’ 
>SELECT ALL BRIEF 


Responses 
The following are examples of a response to the SELECT command. 


>SELECT OPTION CAIN0802 


GROUP : CAIN 
OPTION NAME RTU STATE USAGE LIMIT UNITS LAST CHG 
CAINO802 N ON 99/03/02 


>SELECT NAME ‘Cain Takeback & Transfer’ 


GROUP : CAIN 
OPTION NAME RTU STATE USAGE LIMIT UNITS LAST CHG 
CAINO802 N ON 99/03/02 


>SELECT GROUP ‘NSER’ 


GROUP :NSER 

OPTION NAME RTU STATE USAGE LIMIT UNITS LAST CHG 
NSEROOO1 Network Services Y ON 98/10/20 
NSEROOO2 TCAP Auth & Acct Val N IDLE 98/10/19 
NSEROOO3 Inter/Intra IMT Y ON 98/10/20 
NSEROOO4 Super GD Control Y ON 98/10/20 


>SELECT OPTION CAIN0801 


GROUP: CAIN 
OPTION NAME RTU STATE USAGE LIMIT UNITS LAST CHG 
CAINO801 Midcall Services 2 Y ON 98/09/11 
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>SELECT NAME ‘CAIN MIDCALL SERVICES 2’ 
GROUP : CAIN 
OPTION NAME RTU STATE USAGE LIMIT UNITS LAST CHG 
CAINO801 Midcall Services 2 Y ON 98/09/11 
>SELECT NAME ‘MIDCALL SERVICES 2’ 
GROUP: CAIN 
OPTION NAME RTU STATE USAGE LIMIT UNITS LAST CHG 
CAINO801 Midcall Services 2 Y ON 98/09/11 
>SELECT OPTION CAINO510 
GROUP : CAIN 
OPTION NAME RTU STATE USAGE LIMIT UNITS LAST CHG 
CAINO510 TERMATT N ON 97/06/08 
>SELECT NAME ‘CAIN TERMATT’ 
GROUP: CAIN 
OPTION NAME RTU STATE USAGE LIMIT UNITS LAST CHG 
CAINO510 TERMATT N ON 97/06/08 


>SELECT ALL BRIEF 
CLLI: OTWAONXBDSO SOC OPTION STATUS SUMMARY DATE: 93/11/20 
PCL NAME: TOPS03.1 


GROUP : CTX 

OPTION NAME RTU STATE USAGE LIMIT UNITS LAST CHG 
CTX00075 CALL RETURN N IDLE 94/01/02 
CTX00128 CALL FORWARDING Y ON 94/01/08 
ISTB 

CTX00130 CALL WAITING Y = 578 1000 LINES 94/02/15 
CTX00131 RING AGAIN Y = 350 400 LINES 94/02/15 
>THR 

CTX00153 CALL FORWARD BUSY Y IDLE 94/02/15 
CTX00173 CALLING LINE ID Y — 302 MONITOR LINES 94/02/15 
CTX00180 CONFERENCE Y 94/01/02 
TRAK 

CTX00185 HOT LINE ¥ ON 200 150S LINES 94/01/08 
>LIM 

CTX00187 SPECIAL RING N = 0 O LINES 94/01/02 
CTX00190 SPEED DIAL X = MONITOR LINES 94/02/05 
TRAK 
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CTX00191 PENDING OPTION Y 94/02/05 
PEND 


The following are possible responses to the SELECT command. 


No options in table; nothing to report 


Explanation: 
There are no options known to SOC; no report is generated. 


Packed report written to file <file> on device <dev> 


Explanation: 
User requested a SELECT ALL PACK report. The report was 
successfully generated and written to the named file and device. 


Target file exists. Replace? 


Explanation: 

User requested a SELECT ALL PACK report. SOC discovered there 
is already a file with the target file name on the current device. SOC 
asks if it is acceptable to overwrite the existing file. 


User action: 
Respond with YES or NO. If the response is NO, the report is not 
generated and the file is not overwritten. 


Error messages 


The following error messages may display as a result of the SELECT 
command. 


Internal error accessing SOC database. Report not generated. 
Sorry... 


Explanation: 
SOC experienced some kind of internal failure while trying to 
generate the report. The command is aborted. 


User action: 
Check for SWER logs. Contact Northern Telecom support. 


Memory allocation failure while trying to generate report. 
Report not generated. Sorry... 
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Explanation: 
SOC could not allocate temporary data structures to carry out the 
requested computations. The command is aborted. 


User action: 

Wait until the office is less busy or obtain a memory upgrade. If the 
error is more severe, SOC generates SWER messages to indicate a 
software failure. 


NO options match the selection criteria. 


Explanation: 

User requested a report for the options with a particular 
characteristic, but SOC found no matching options. The command is 
halted. 


User action: 
Try different selection criteria or use SELECT ALL. 


Related commands 
The following commands are related: 


ASSIGN 
DBAUDIT 
REMOVE 
RESET_AUDIT 
RESET 
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VALIDATE (continued) 


Purpose 
The Validate (VALIDATE) command tests whether the SOC option you 
specify can be successfully changed from one state to another. 
Access 
Syntax 
>VALIDATE <order code> <state> 
Parameters 
The command parameters are described in Table 1-42. 
Table 1-42 
VALIDATE parameter descriptions 
Parameter Values Description 
Order code 8 alphanumeric A Northern Telecom-defined order code used to 
characters identify options (for example, CAINO607) 
State IDLE The state to which the transition is being tested 
ON 
—end— 


Example command 


The following are examples of the VALIDATE command. 


CAINO607 is idle 


>VALIDATE CAINO607 IDLE 


OPTION CAINO607: CURRENT STATE: 
INDICATED STATE: 


VALIDATION NOT PERFORMED. THE OPTION IS ALREADY IN THE 


INDICATED STATE. 


CAINO607 is idle and RTU is not granted 


>VALIDATE CAINO607 ON 


OPTION CAINO607: CURRENT STATE: 
INDICATED STATE: 
RIGHT TO USE NOT GRANTED 


SOC DETECTED ERRORS. 


THE INDICATED STATE 


IDL] 
IDL] 


Gl Fl 


IDLE 


ON 


= 


ry 


TRANSITION MAY FAIL. 
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VALIDATE (end) 


CAINO607 is idle and RTU is granted 


>VALIDATE CAINO607 ON 
OPTION CAINO607: CURRENT STATE: IDLE 
INDICATED STATE: ON 
SOC DETECTED NO ERRORS. THE INDICATED STATE TRANSITION SHOULD 
SUCCEED. 


CAINO607 is on 


>VALIDATE CAINO607 ON 
OPTION CAINO607: CURRENT STATE: ON 
INDICATED STATE: ON 
VALIDATION NOT PERFORMED. THE OPTION IS ALREADY IN THE 
INDICATED STATE. 


CAINO607 is on 


Responses 


>VALIDATE CAINO607 IDLE 
OPTION CAINO607: CURRENT STATE: ON 

INDICATED STATE: ON 
NETWORKBUILDER VIRTUAL IP WILL BE DISABLED IF THIS SOC OPTION 
IS SET TO THE IDLE STATE. 
SOC DETECTED NO ERRORS. THE INDICATED STATE TRANSITION SHOULD 
SUCCEED. 


See the Example command section. 


Related commands 


The following commands are related: 


e ASSIGN 

e DBAUDIT 

e REMOVE 

e RESET 

e RESET_AUDIT 
e SELECT 
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TTP directory 

TTP (end) 

Purpose 
TTP accesses the TTP directory. 

Access 
All TTP commands are accessed through the following command: 
>MAPCI;MTC;TRKS;TTP 

Syntax 


> 


Related commands 
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FRLS 


Purpose 


The FRLS (FoRce ReLeaSe) command forces the call processing busy 
circuit in the control position to the manual busy state. If the circuit is 
involved in a wideband call, a warning message appears at the MAP 
terminal. You must confirm the release of the call. 


You must identify the circuit using the POST command before issuing the 
FRLS command. (See “Related commands” for information about the POST 
command.) 


The system limitations regarding the use of this command are as follows: 


e Wideband traffic trunks are supported only when datafilled as one-way 
trunks. 


e All DSOs involved in the wideband call must be on the same DS1. 
e Monitoring the trunks from maintenance should not be done. 


e Continuity testing (COT) is disabled for wideband calls. COT is 
available for narrowband calls using wideband trunk groups. COT 
verifies speech path over a single DSO before allowing the call to be set 


up. 


Access 
FRLS can be accessed by typing any of the following: 


>MAPCI;MTC;TRKS;TTP 
>MAPCI;MTC;TRKS;TTP;MONITOR 
>MAPCI;MTC;TRKS;TTP;MANUAL 
>MAPCI;MTC;TRKS;TTP;C7TTP 


Syntax 


Parameters 


Example command 


> 
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FRLS (end) 


Responses 


As a response to the FRLS command, the system may display the warning 
message shown in the following example. 


>FRLS 
*WARNING* 


This circuit is involved in a wide band call. 
Do you want to FRLS trunk? 
PLEASE CONFIRM (“YES” or “NO”): 


Related commands 


Use the POST command to identify the circuit against which you issue the 
FRLS command. 
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ACG 

See automatic code gapping. 
AIN 

Advanced Intelligent Network 
AINF 

AIN Final treatment 
ANI 

See automatic number identification. 
ANM 


Answer Message 


automatic code gapping 
A unique, multidigit code identifying an authorized subscriber. 


automatic number identification 
A system that automatically identifies a calling number and transmits it to 
the AMA office equipment for billing. 


BAF 
Bellcore AMA format 


BC 


See bearer capability. 


bearer capability 
A characteristic associated with a directory number, which indicates the type 
of call (voice or data) and the rate of transmission allowed. Bearer capability 
is also an information element carried in the setup message for functional 
signaling to indicate the type of call (voice or data) and the rate of 
transmission required (for ISDN). 


CAIN 


Carrier Advanced Intelligent Network 
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calling card number 
Subscriber number used in billing. 


call processing busy 
The state in which call processing is taking place and the equipment 
involved cannot be seized for maintenance. 


CCAN 

calling card account number 
CCN 

See calling card number. 
CCSAN 

calling card sub account number 
CCS7 


See Common Channel Signaling 7. 


central processing unit 
A hardware entity, located in the central control complex frame, that 
contains the central data processor for the DMS Family system. The CPU 
controls and performs the execution of instructions. 


CDR 

call detail record 
CDRTMPLT 

CDR Template table 
Cl 

See command interpreter. 
CIC 

Carrier Identification Code 
CLLI 


See common language location identifier. 


command interpreter 
A support operating system component that functions as the main interface 
between machine and user. Its principal roles are to read lines entered by a 
terminal user, to break each line into recognizable units, to analyze the units, 
to recognize command item-numbers on the input lines, and to invoke these 
commands. 
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Common Channel Signaling 7 
A digital, message-based network signaling standard defined by the CCITT 
that separates call signaling information from voice channels so that 
interoffice signaling is exchanged over a separate signaling link. 


common language location identifier 
A standard identification method for trunk groups in the following form: aaa 
is the city code; bb is the province or state code; xx is the trunk group 
identifier; and yyyy is the trunk number. 


COT 

continuity test message 
CPB 

See call processing busy. 
CPN 

Calling Party NUmber 
CPU 

See central processing unit. 
CTR 

Connect_To_Resource 
DAL 

See dedicated access line. 
DDM 


distributed data management 


dedicated access line 
An unswitchable, dedicated line or trunk used for voice or data 
communication that connects two network components. A trunk interface 
that connects a PBX, a key system, or a single telephone to a DMS-250 
switch. 


digital trunk controller 
A peripheral module that connects DS-30 links from the network to digital 
trunk circuits. 


DMS 
Digital Multiplex System 


DN 


Directory Number 
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DP 


DST 


DT 


DTC 


Detection Point 


daylight savings time 


direct termination 


See digital trunk controller. 


feature group D 


EANT 


ECHODATA 


EDP 


FCDRSRCH 


FGD 


FSD 


GAP 


Multifrequency- or CCS7-based signaling protocol defined between an equal 
access end office and an interexchange carrier office to provide subscribers 
access to interexchange carriers. Subscribers use standard 1+ dialing to 
access the interexchange carrier network. Subscriber identification is 
achieved by passing the subscriber’s automatic number identification from 
the equal access end office to the interexchange carrier over the FGD 
interface. 


Equal Access Network Trunk 


ECHODATA 


Event Detection Point 


Flex—CDR version of CDR search 


See feature group D. 


Feature Group D (EANT) 


Generic Address Parameter 
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global title 


An application address that does not explicitly contain the necessary 
information that would allow routing by the signaling connection control 
part of the message transfer part. The signaling connection control part 
global title translation function is required to translate a GT into a valid 
network address. 


global title translation 


GMT 


GT 


GTT 


IAM 


IBN 


The process that translates an application-specific address (such as a dialed 
800 number) into the Common Channel Signaling 7 network address. 


Greenwich mean time 


See global title. 


See global title translation. 


Initial Address Message 


See Integrated Business Network. 


Integrated Business Network 


IEC/IXC/IC 


IMT 


INC 


Now known as Meridian Digital Centrex. A special DMS business services 
package that uses the data-handling capabilities of DMS Family offices to 
provide a centralized telephone exchange service. 


Inter—Exchange Carrier 


Inter—machine Trunk 


Intelligent Network 


Intelligent Network 1 


International Carrier 
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IP 
Intelligent Peripheral 


ISDN 


Integrated Services Digital Network 


ISDN User Part 
A Common Channel Signaling 7 message-based signaling protocol that acts 
as a transport carrier for ISDN services. ISUP provides the functionality in a 
CCS7 network for voice and data services. 


ISUP 

See ISDN User Part. 
LATA 

local access and transport area 
LEAS 

LATA equal access system 
LEC 

See local exchange carrier. 
LIDB 


line information database 


link interface unit 7 
A peripheral module that processes messages entering and leaving a link 
peripheral processor through an individual signaling data link. 


LIU7 


See link interface unit 7. 


LNP 
Local Number Portability 


local access and transport area 
A geographic area within which an operating company may offer 
telecommunications-related services. 


local exchange carrier 
The exchange where subscribers’ lines terminate. The carrier is authorized 
to originate and terminate local subscriber transmissions. LEC provides line 
side access to subscribers. 
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manual busy 


MB 


A busy state that is manually imposed on a trunk by operating a panel 
control or entering a command at the keyboard of a VDU. Manual busy is 
the state of a trunk circuit that is removed from service in this manner. 


manual busy 


Message Transfer Part 


MPA 


MTP 


NCS 


NETSEC 


Provides a connection-less transport system for carrying CCS6, CCIS6 and 
CCS7 signaling messages between user locations or applications functions. 
MTP is a CCITT N7 protocol. Also known as message transport part. 


Multiple Profile ANI 


See Message Transfer Part. 


See network control system. 


NETwork SECurity 


network control system 


NOA 


NPA 


NPI 


NSF 


NTP 


OFRT 


A software system used for real-time surveillance and management of a data 
packet network. 


Nature Of Address 


Numbering Plan Area 


numbering plan indicator 


network service facility 


Northern Telecom Publication 


Office Route 
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ONAT 


See offnet access trunk. 


ONP 
One Night Process 


offnet access trunk 
Trunks permitting telephone subscribers in the U.S. to use the facilities of 
specialized other common carriers without degraded transmission and 
supervisory services. DMS-250 trunk type that supports feature group B and 
feature group C signaling. It connects a DMS-250 switch to the trunk side of 
a class 5 central office. Also labeled as feature group B or feature group C. 


OSR 

operator services record 
PBX 

Private Branch Exchange 
PCL 


product computing-module load 


personal identification number 
A unique number used along with an access code to activate a service, such 
as subscriber activated call blocking. The PIN provides security for the 
subscriber from unauthorized use of a service. 


PIC 
point in call 
PIN 
See personal identification number. 
POTS 
Plain Old Telephone System 
PRA 
See primary rate access. 
PRI 


See primary rate interface. 


primary rate access 
The primary rate access interfaces between the user’s equipment and public 
network switches or other PBXs equipped with ISDN. 
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primary rate interface 
Primary rate interface links private networking facilities, such as PBXs, 
local area networks, and host computers; a standardized architecture acts as 
the bridge between private switching equipment and the public network. 


PTS 

Per Trunk Signalling 
RAO 

regional accounting office 
RDB 


See remote database. 


remote database 
A database that is remote from the DMS-250 switch. This is another term 


used for SCP. 
RLT 

release link trunk 
RRBCME 

Request_Report_BCM_Event 
RTS 

return to service 
RU 

Recording Unit 
SDM 

Supernode Data Manager 
SCP 


See service control point. 


service control point 
A network note that provides information to other notes (database access). 


SER 


switch event record 


service switching point 
A switching point that communicates with the service control point. 
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signaling system 7 
A dual processor device with an 8085-based master processor and an 
803 1-based data link processor resident in a single card in the message 
switch and buffer 7 frame. 


signaling transfer point 
A signaling point that does not generate or terminate signaling messages, but 
transfers messages between incoming and outgoing signaling links. 


SOC 


See software optionality control. 


software optionality control 
Software optionality control is the tool for managing options in a product 
computing-module load (PCL). Both base and optional functionality is 
present in a PCL. Base functionality is available for immediate use. Optional 
functionality is grouped into commercial units called SOC options. These 
can be purchased and activated by operating companies without software 
reloads or restarts. Optional functionality includes card services, network 
services, and dialable wideband services. 


SS7 

See signaling system 7. 
SSP 

See service switching point. 
STDPRT 

Standard Pretranslator 
STDPRTCT 

Standard Pretranslator Control Table 
STR 

Send_To_Resource 
STP 

See signaling transfer point. 
STS 

serving translation scheme 
TBCD 

See telephone binary coded decimal. 
TCAP 


See transaction capabilities application part. 
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TDP 


trigger detection point 


telephony binary coded decimal 


TERMRTE 


TID 


TNS 


The type of filler digits added to the subscriber-dialed digits to make a 
complete telephone number. 


Treatment Route 


terminal identifier 


transit network selection 


translation capabilities application part 


TRTIMTCO 


UCS 


VAMP 


VNET 


WZ1 


WZONE 


A service that provides a common protocol for remote operations across the 
Common Channel Signaling 7 network. The protocol consists of message 
formatting, content rules, and exchange procedures. 


Treatment Code 


Universal Carrier Services 


Variable AIN Messaging Platform 


virtual network 


World Zone 1 


World ZONE 
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Ordering information 


Use the following table for ordering Nortel NTPs (Northern Telecom 
Publications) and Product Computing-Module Loads (PCLs): 


Type of product Source Phone Cost 
Technical documents Nortel Product 1-877-662-5669, Yes 
(paper or CD-ROM) Documentation Option 4 + 1 
Individual NTPs (paper) Merchandising 1-800-347-4850 Yes 
Order Service 
Marketing documents Sales and Marketing 1-800-4NORTEL No 
Information Center (1-800-466-7835) 
(SMIC) * ESN 444-5930 
PCL software Nortel Consult your Yes 
Nortel sales 
representative 
* Employee 


When ordering publications on CD 


Please have the CD number and software version available, for example, 
HLM-2621-001 02.02. 


When ordering individual paper documents 


Please have the document number and name available, for example, 
297-2621-001, UCS DMS-250 Master Index of Publications. 


When ordering software 

Please have the eight-digit ordering code, for example, UCSE0009, as well 
as the ordering codes for the features you wish to purchase. Contact your 
Nortel representative for assistance. 
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